Metadata-Version: 2.1
Name: feno
Version: 0.2.5
Summary: feno: Flexible Exercise Notation Organizer
Home-page: https://github.com/senapk/feno
Author: David Sena Oliveira
Author-email: sena@ufc.br
Project-URL: Bug Reports, https://github.com/senapk/feno/issues
Project-URL: Source, https://github.com/senapk/feno/
Keywords: programming,learning
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Topic :: Education
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.7, <4
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: build
Requires-Dist: twine
Provides-Extra: dev
Requires-Dist: check-manifest ; extra == 'dev'
Provides-Extra: test
Requires-Dist: coverage ; extra == 'test'

# feno - Flexible Exercise Notation Organizer

A ferramenta `feno` é um formatador de atividades de programação e conta com uma série de ferramentas integradas.

- Um preprocessador de Markdown (toc, include).
- Um gerador de arquivos html usando pandoc.
- Um gerador de links absolutos para arquivos locais.
- Uma ferramenta para filtrar rascunhos de código.
- Um indexador de questões.
- Um gerador de arquivos para serem utilizados no VPL do Moodle ou via tko.

## Instalação

Se estiver no windows, instale o [WSL](https://docs.microsoft.com/pt-br/windows/wsl/install) e utilize o Ubuntu.

```bash
pip install feno

# ou diretamente do github
pip install git+https://github.com/senapk/feno.git

# tko para gerar e converter os testes e testar os códigos
pip install tko

# pandoc para gerar os htmls se quiser htmls de qualidade e com suporte a latex
sudo apt install pandoc
```

## Modo básico

Crie um arquivo `Readme.md` com o seguinte formato:

    # Título da atividade

    A descrição que você quiser

    ```txt
    >>>>>>>> teste 1
    entrada
    entrada
    ========
    saida
    saida
    <<<<<<<<
    
    >>>>>>>> teste 2
    entrada
    entrada
    ========
    saida
    saida
    <<<<<<<<

    ```

- A primeira linha é o título da atividade.
- Você pode inserir quantos testes quiser.
- Execute o `feno` na pasta local com:

```bash
feno .
```

Ele vai criar uma pasta `.cache` com:

- `q.html` - Um arquivo html com a descrição do problema.
- `q.tio` - Um arquivo com as questões no formato tio.
- `mapi.json` - Um arquivo com os testes formatado para o moodle, que pode ser utilizado pelo projeto [mula](https://github.com/senapk/mula).

## Utilizando TOC e rascunhos


