Metadata-Version: 2.3
Name: aprender
Version: 0.1.0
Summary: CLI tool to parse aprender.unb.br, a Moodle instance at the University of Brasília
Author: Fábio Macêdo Mendes
Author-email: Fábio Macêdo Mendes <fabiomacedomendes@gmail.com>
Requires-Dist: beautifulsoup4>=4.14.3
Requires-Dist: pydantic>=2.13.4
Requires-Dist: rich>=15.0.0
Requires-Dist: ruamel-yaml>=0.19.1
Requires-Dist: typer>=0.25.1
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# Aprender.unb.br

CLI interface to access the Moodle instance of the University of Brasilia (UnB).
With a few modifications (or maybe even without any), it can be used to access
other Moodle configurations.


## Installation

Use pip or any standard Python tooling to install it:

```bash
$ pip install aprender

# or maybe you prefer uvx or pipx
$ uv tool install aprender
```

My prefered way is to install [uv](http://astral.sh/uv/) and create an alias in 
.bashrc (or the equivalent) for your shell:

```bash
alias aprender='uvx aprender'
```

## Usage

Download the grades and/or submissions for an quiz in HTML. This is necessary
because Moodle corrupts the output in other formats like CSV and JSON by striping
whitespaces from essay submissions. 

Save the HTML file in the current directory and run:

```bash
$ aprender load
```

This will create a few csv files in the current directory with the parsed data.

For more options, as usual, `aprender --help` flag is your friend.

