sanctus.hck/exercism_puzzles
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

primeiro commit com exercicios de Exercism realizados até esta data

Browse Source
This commit is contained in:
sanctus.hck
2026-10-17 22:10:27 +01:00
commit 58fccbe27a
708 changed files with 35038 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
python/say/HELP.md
+130
View File
@@ -0,0 +1,130 @@
# Help
## Correr os testes
Usamos o [pytest][pytest: Getting Started Guide] como executor de testes do nosso site.
Vais precisar de instalar o `pytest` na tua máquina de desenvolvimento se quiseres correr os testes do percurso Python localmente.
Também vais precisar de instalar os seguintes plugins do `pytest`:
- [pytest-cache][pytest-cache]
- [pytest-subtests][pytest-subtests]
Encontras informação mais detalhada no [guia de testes de Python][Python track tests page] do nosso site.
### Correr os testes
Para correres os testes incluídos, navega até à pasta onde o exercício está guardado usando o `cd` no teu terminal (_substitui `<exercise-folder-location>` abaixo pelo teu caminho_).
Os ficheiros de teste terminam habitualmente em `_test.py` e são os mesmos testes que correm no site quando uma solução é submetida.
Linux/MacOS
```bash
$ cd <path/to/exercise-folder-location>
```
Windows
```powershell
PS C:\Users\foobar> cd <path\to\exercise-folder-location>
```
<br>
De seguida, corre o comando `pytest` no teu terminal, substituindo `<exercise_test.py>` pelo nome do ficheiro de teste:
Linux/MacOS
```bash
$ python3 -m pytest -o markers=task <exercise_test.py>
==================== 7 passed in 0.08s ====================
```
Windows
```powershell
PS C:\Users\foobar> py -m pytest -o markers=task <exercise_test.py>
==================== 7 passed in 0.08s ====================
```
### Opções comuns
- `-o` : substitui o `pytest.ini` predefinido (_podes usar esta opção para evitar avisos de marcadores_)
- `-v` : ativa a saída detalhada.
- `-x` : para de correr os testes na primeira falha.
- `--ff` : corre as falhas do teste anterior antes de correr os outros casos de teste.
Para opções adicionais, usa `python3 -m pytest -h` ou `py -m pytest -h`.
### Corrigir avisos
Se não usares `pytest -o markers=task` ao invocar o `pytest`, podes receber um `PytestUnknownMarkWarning` nos testes que usam a nossa nova sintaxe:
```bash
PytestUnknownMarkWarning: Unknown pytest.mark.task - is this a typo? You can register custom marks to avoid this warning - for details, see https://docs.pytest.org/en/stable/mark.html
```
Para evitares escrever `pytest -o markers=task` em todos os testes que corres, podes usar um ficheiro de configuração `pytest.ini`.
Criámos um que podes descarregar a partir do nível de topo do diretório do percurso Python: [pytest.ini][pytest.ini].
Também podes criar o teu próprio ficheiro `pytest.ini` com o seguinte conteúdo:
```ini
[pytest]
markers =
task: A concept exercise task.
```
Colocar o ficheiro `pytest.ini` no diretório _root_ ou _working_ dos teus exercícios do percurso Python regista os marcadores e faz parar os avisos.
Encontras mais informação sobre os marcadores do pytest na documentação do `pytest` sobre [marcar funções de teste][pytest: marking test functions with attributes] e na documentação do `pytest` sobre [trabalhar com marcadores personalizados][pytest: working with custom markers].
Encontras informação sobre como personalizar as configurações do pytest na documentação do `pytest` sobre [formatos de ficheiros de configuração][pytest: configuration file formats].
### Estender o teu IDE ou editor de código
Muitos IDEs e editores de código têm suporte integrado para usar o `pytest` e outras ferramentas de qualidade de código.
Podes encontrar algumas opções da comunidade na nossa [página de ferramentas do percurso Python][Python track tools page].
[Pytest: Getting Started Guide]: https://docs.pytest.org/en/latest/getting-started.html
[Python track tools page]: https://exercism.org/docs/tracks/python/tools
[Python track tests page]: https://exercism.org/docs/tracks/python/tests
[pytest-cache]:http://pythonhosted.org/pytest-cache/
[pytest-subtests]:https://github.com/pytest-dev/pytest-subtests
[pytest.ini]: https://github.com/exercism/python/blob/main/pytest.ini
[pytest: configuration file formats]: https://docs.pytest.org/en/6.2.x/customize.html#configuration-file-formats
[pytest: marking test functions with attributes]: https://docs.pytest.org/en/6.2.x/mark.html#raising-errors-on-unknown-marks
[pytest: working with custom markers]: https://docs.pytest.org/en/6.2.x/example/markers.html#working-with-custom-markers
## Submeter a tua solução
Podes submeter a tua solução com o comando `exercism submit say.py`.
Este comando envia a tua solução para o site do Exercism e imprime o URL da página da solução.
É possível submeter uma solução incompleta, o que te permite:
- Ver como outras pessoas resolveram o exercício
- Pedir ajuda a um mentor
## Precisas de ajuda?
Se quiseres ajuda para resolver o exercício, consulta as seguintes páginas:
- A [documentação do percurso Python](https://exercism.org/docs/tracks/python)
- A [categoria de programação do percurso Python no fórum](https://forum.exercism.org/c/programming/python)
- A [categoria de programação do Exercism no fórum](https://forum.exercism.org/c/programming/5)
- As [Perguntas Frequentes](https://exercism.org/docs/using/faqs)
Se esses recursos não forem suficientes, podes submeter a tua solução (incompleta) para pedir mentoria.
Abaixo encontras alguns recursos para obter ajuda, caso tenhas problemas:
- [A PSF](https://www.python.org) aloja as transferências do Python, a documentação e recursos da comunidade.
- Os [Fóruns da Comunidade Python](https://discuss.python.org/) servem para obter ajuda, discutir PEPs, falar com os principais contribuidores do Python e muito mais.
- [A Comunidade do Exercism no Discord](https://exercism.org/r/discord)
- [Os Fóruns de Discussão da Comunidade do Exercism](https://forum.exercsim.org)
- A [Comunidade Python no Discord](https://pythondiscord.com/) é uma comunidade muito prestável e ativa.
- O [/r/learnpython/](https://www.reddit.com/r/learnpython/) é um subreddit pensado para quem está a aprender Python.
- O [#python no Libera.chat](https://www.python.org/community/irc/) é o sítio onde os programadores responsáveis pela linguagem se juntam e põem o trabalho em dia.
- Os [Fóruns da Comunidade Free Code Camp](https://forum.freecodecamp.org/)
- O [Pythontutor](http://pythontutor.com/) para percorrer pequenos excertos de código visualmente.
Além disso, o [StackOverflow](http://stackoverflow.com/questions/tagged/python) é um bom sítio para procurar o teu problema ou a tua dúvida e ver se já foi respondida.
Se não foi, podes sempre [perguntar](https://stackoverflow.com/help/how-to-ask) ou [responder](https://stackoverflow.com/help/how-to-answer) à pergunta de outra pessoa.