# 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
Raw data
{
"_id": null,
"home_page": "https://github.com/senapk/feno",
"name": "feno",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.7",
"maintainer_email": null,
"keywords": "programming, learning",
"author": "David Sena Oliveira",
"author_email": "sena@ufc.br",
"download_url": "https://files.pythonhosted.org/packages/64/33/45197d53292bab28eb9d9e43a79895edc5066b682ddd64475bb42bf91f49/feno-0.2.3.tar.gz",
"platform": null,
"description": "# feno - Flexible Exercise Notation Organizer\n\nA ferramenta `feno` \u00e9 um formatador de atividades de programa\u00e7\u00e3o e conta com uma s\u00e9rie de ferramentas integradas.\n\n- Um preprocessador de Markdown (toc, include).\n- Um gerador de arquivos html usando pandoc.\n- Um gerador de links absolutos para arquivos locais.\n- Uma ferramenta para filtrar rascunhos de c\u00f3digo.\n- Um indexador de quest\u00f5es.\n- Um gerador de arquivos para serem utilizados no VPL do Moodle ou via tko.\n\n## Instala\u00e7\u00e3o\n\nSe estiver no windows, instale o [WSL](https://docs.microsoft.com/pt-br/windows/wsl/install) e utilize o Ubuntu.\n\n```bash\npip install feno\n\n# ou diretamente do github\n\npip install git+https://github.com/senapk/feno.git\n\n# tko para gerar e converter os testes e testar os c\u00f3digos\npip install tko\n\n# pandoc para gerar os htmls se quiser htmls de qualidade e com suporte a latex\nsudo apt install pandoc\n```\n\n## Modo b\u00e1sico\n\nCrie um arquivo `Readme.md` com o seguinte formato:\n\n # T\u00edtulo da atividade\n\n A descri\u00e7\u00e3o que voc\u00ea quiser\n\n ```txt\n >>>>>>>> teste 1\n entrada\n entrada\n ========\n saida\n saida\n <<<<<<<<\n \n >>>>>>>> teste 2\n entrada\n entrada\n ========\n saida\n saida\n <<<<<<<<\n\n ```\n\n- A primeira linha \u00e9 o t\u00edtulo da atividade.\n- Voc\u00ea pode inserir quantos testes quiser.\n- Execute o `feno` na pasta local com:\n\n```bash\nfeno .\n```\n\nEle vai criar uma pasta `.cache` com:\n\n- `q.html` - Um arquivo html com a descri\u00e7\u00e3o do problema.\n- `q.tio` - Um arquivo com as quest\u00f5es no formato tio.\n- `mapi.json` - Um arquivo com os testes formatado para o moodle, que pode ser utilizado pelo projeto [mula](https://github.com/senapk/mula).\n\n## Utilizando TOC e rascunhos\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "feno: Flexible Exercise Notation Organizer",
"version": "0.2.3",
"project_urls": {
"Bug Reports": "https://github.com/senapk/feno/issues",
"Homepage": "https://github.com/senapk/feno",
"Source": "https://github.com/senapk/feno/"
},
"split_keywords": [
"programming",
" learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "72b5602d1c95dbcf4e1509da7f450846296a0cadead06bc91a5481e1274081b5",
"md5": "bee3973806320567de5fc980f975befd",
"sha256": "71820cfe4b35ac83d2190f902c7c99b32e3911d5343cb4827867f298b268159b"
},
"downloads": -1,
"filename": "feno-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bee3973806320567de5fc980f975befd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.7",
"size": 21886,
"upload_time": "2024-04-25T16:30:00",
"upload_time_iso_8601": "2024-04-25T16:30:00.478336Z",
"url": "https://files.pythonhosted.org/packages/72/b5/602d1c95dbcf4e1509da7f450846296a0cadead06bc91a5481e1274081b5/feno-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "643345197d53292bab28eb9d9e43a79895edc5066b682ddd64475bb42bf91f49",
"md5": "88c97272dd89111e27871dc2b30e778e",
"sha256": "971181b9289a42b17a0537a71bd9c581ef40a3a3b3da01470c5dc55b282032b6"
},
"downloads": -1,
"filename": "feno-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "88c97272dd89111e27871dc2b30e778e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.7",
"size": 20775,
"upload_time": "2024-04-25T16:30:01",
"upload_time_iso_8601": "2024-04-25T16:30:01.989955Z",
"url": "https://files.pythonhosted.org/packages/64/33/45197d53292bab28eb9d9e43a79895edc5066b682ddd64475bb42bf91f49/feno-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-25 16:30:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "senapk",
"github_project": "feno",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "build",
"specs": []
},
{
"name": "twine",
"specs": []
}
],
"lcname": "feno"
}