<commit_before><div align="center">
<h1>
<img src="https://raw.githubusercontent.com/TheXDS/MCART/master/Art/MCART.png" alt="MCART" align="middle" heigth="64px" width="64px">
MCART
</h1>
</div>

[![CodeFactor](https://www.codefactor.io/repository/github/thexds/mcart/badge)](https://www.codefactor.io/repository/github/thexds/mcart)
[![Build MCART](https://github.com/TheXDS/MCART/actions/workflows/build.yml/badge.svg)](https://github.com/TheXDS/MCART/actions/workflows/build.yml)
[![Publish MCART](https://github.com/TheXDS/MCART/actions/workflows/publish.yml/badge.svg)](https://github.com/TheXDS/MCART/actions/workflows/publish.yml)
[![Versión estable](https://buildstats.info/nuget/TheXDS.MCART)](https://www.nuget.org/packages/TheXDS.MCART/)
[![Versión de desarrollo](https://buildstats.info/nuget/TheXDS.MCART?includePreReleases=true)](https://www.nuget.org/packages/TheXDS.MCART/)
[![Issues](https://img.shields.io/github/issues/TheXDS/MCART)](https://github.com/TheXDS/MCART/issues)
[![GPL-v3.0](https://img.shields.io/github/license/TheXDS/MCART)](https://www.gnu.org/licenses/gpl-3.0.en.html)

## Introducción
MCART es un conjunto de funciones, extensiones y módulos que he encontrado
útiles a lo largo de mis años de experiencia con lenguajes .Net,
particularmente con Visual Basic. Trata de añadir características que no se
encuentran fácilmente disponibles en .Net Framework, y además añade controles,
ventanas, recursos y otros objetos de utilidad.

Actualmente, se encuentra en una muy temprana fase Alpha, por lo que podría
tener bugs o problemas serios de rendimiento. He puesto mucho esfuerzo en
mantener un código funcional y, espero, libre de errores obvios. Sin embargo,
no puedo asegurar que MCART pueda ser utilizado en un paquete de software en su
estado actual.

## Composición del proyecto
MCART se compone de varios proyectos, y distintos proyectos de código
compartido entre las plataformas. En ellos reside la raíz de la mayoría de
características que pueden funcionar en diferentes entornos CIL. La
funcionalidad está comprobada con .Net 5.0 y Mono; lo que debería ser suficiente
para crear aplicaciones basadas en Win32, WPF, Gtk#, consola e incluso sitios
web desarrollados en ASP .Net.

## Releases
MCART se encuentra disponible en NuGet.

**Package Manager**  
`PM> Install-Package TheXDS.MCART`

**.NET CLI**  
`> dotnet add package TheXDS.MCART`

**Paket CLI**  
`> paket add TheXDS.MCART`

## Compilación
MCART requiere de un compilador compatible con C# 9.0, debido a ciertas
características especiales del lenguaje que ayudan a disminuir la
complejidad del código.

MCART también requiere que [.Net SDK](https://dotnet.microsoft.com/) 5.0
esté instalado en el sistema.<commit_msg>Actualización de documentación<commit_after><table>
<tr>
<td>
<h1>
<img src="https://raw.githubusercontent.com/TheXDS/MCART/master/Art/MCART.png" width="96px">
MCART
</h1>
</td>
<td>

[![CodeFactor](https://www.codefactor.io/repository/github/thexds/mcart/badge)](https://www.codefactor.io/repository/github/thexds/mcart)
[![Build MCART](https://github.com/TheXDS/MCART/actions/workflows/build.yml/badge.svg)](https://github.com/TheXDS/MCART/actions/workflows/build.yml)
[![Publish MCART](https://github.com/TheXDS/MCART/actions/workflows/publish.yml/badge.svg)](https://github.com/TheXDS/MCART/actions/workflows/publish.yml)
[![Versión estable](https://buildstats.info/nuget/TheXDS.MCART)](https://www.nuget.org/packages/TheXDS.MCART/)
[![Versión de desarrollo](https://buildstats.info/nuget/TheXDS.MCART?includePreReleases=true)](https://www.nuget.org/packages/TheXDS.MCART/)
[![Issues](https://img.shields.io/github/issues/TheXDS/MCART)](https://github.com/TheXDS/MCART/issues)
[![GPL-v3.0](https://img.shields.io/github/license/TheXDS/MCART)](https://www.gnu.org/licenses/gpl-3.0.en.html)

</td>
</tr>
</table>

## Introducción
MCART es un conjunto de funciones, extensiones y módulos que he encontrado
útiles a lo largo de mis años de experiencia con lenguajes .Net,
particularmente con Visual Basic. Trata de añadir características que no se
encuentran fácilmente disponibles en .Net Framework, y además añade controles,
ventanas, recursos y otros objetos de utilidad.

Actualmente, se encuentra en una muy temprana fase Alpha, por lo que podría
tener bugs o problemas serios de rendimiento. He puesto mucho esfuerzo en
mantener un código funcional y, espero, libre de errores obvios. Sin embargo,
no puedo asegurar que MCART pueda ser utilizado en un paquete de software en su
estado actual.

## Composición del proyecto
MCART se compone de varios proyectos, y distintos proyectos de código
compartido entre las plataformas. En ellos reside la raíz de la mayoría de
características que pueden funcionar en diferentes entornos CIL. La
funcionalidad está comprobada con .Net 5.0; lo que debería ser suficiente
para crear aplicaciones basadas en Win32, WPF, Gtk#, consola e incluso sitios
web desarrollados en ASP .Net.

## Releases
MCART se encuentra disponible en NuGet y en mi repositorio privado de GitHub.

**Package Manager**  
```sh
PM> Install-Package TheXDS.MCART
```

**.NET CLI**  
```sh
dotnet add package TheXDS.MCART
```

**Paket CLI**  
```sh
paket add TheXDS.MCART
```

**Referencia de paquete**  
```xml
<PackageReference Include="TheXDS.MCART" Version="0.15.0.1" />
```

**Ventana interactiva (CSI)**  
```
#r "nuget: TheXDS.MCART, 0.15.0.1"
```

#### Repositorio de GitHub
Para obtener los paquetes de MCART directamente desde GitHub, es necesario
agregar mi repositorio privado. Paar lograr esto, solo es necesario
ejecutar en una terminal:
```sh
nuget sources add -Name "TheXDS GitHub Repo" -Source https://nuget.pkg.github.com/TheXDS/index.json
```

## Compilación
MCART requiere de un compilador compatible con C# 9.0, debido a ciertas
características especiales del lenguaje que ayudan a disminuir la
complejidad del código.

MCART también requiere que [.Net SDK 5.0](https://dotnet.microsoft.com/) o
posterior esté instalado en el sistema.

### Compilando MCART
```sh
dotnet build ./src/MCART.sln
```
Los binarios se encontarán en la carpeta `Build` en la raíz del repositorio.

### Ejecutando pruebas
```sh
dotnet test ./src/MCART.sln
```
{'fraction_non_alphanumeric': 0.12265675500969618, 'fraction_numerical': 0.007110536522301228, 'mean_word_length': 5.061704211557297, 'pattern_counts': {'":': 0, '<': 20, '<?xml version=': 0, '>': 24, 'https://': 33, 'lorem ipsum': 0, 'www.': 10, 'xml': 1}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6730492', 'n_tokens_mistral': 2292, 'n_tokens_neox': 2232, 'n_words': 604}