primeiro commit com exercicios de Exercism realizados até esta data

This commit is contained in:
2026-10-17 22:10:27 +01:00
commit 58fccbe27a
708 changed files with 35038 additions and 0 deletions
@@ -0,0 +1,32 @@
{
"authors": [],
"contributors": [
"behrtam",
"BethanyG",
"cmccandless",
"crsmi",
"Dog",
"ikhadykin",
"kytrinyx",
"lowks",
"N-Parsons",
"pheanex",
"sjakobi",
"subkrish",
"tqa236"
],
"files": {
"solution": [
"prime_factors.py"
],
"test": [
"prime_factors_test.py"
],
"example": [
".meta/example.py"
]
},
"blurb": "Compute the prime factors of a given natural number.",
"source": "The Prime Factors Kata by Uncle Bob",
"source_url": "https://web.archive.org/web/20221026171801/http://butunclebob.com/ArticleS.UncleBob.ThePrimeFactorsKata"
}
@@ -0,0 +1 @@
{"track":"python","exercise":"prime-factors","id":"2bcba47200a345c1839382ac84cc4b11","url":"https://exercism.org/tracks/python/exercises/prime-factors","handle":"sanctushck","is_requester":true,"auto_approve":false}
+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 prime_factors.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.
+63
View File
@@ -0,0 +1,63 @@
# Fatores primos
Bem-vindo ao Fatores primos no percurso Python do Exercism.
Se precisares de ajuda para correr os testes ou para submeter o teu código, consulta o `HELP.md`.
## Instructions
Calcula os fatores primos de um número natural.
Um número primo só é divisível por si próprio e por 1.
Repara que 1 não é um número primo.
## Exemplo
Quais são os fatores primos de 60?
- O nosso primeiro divisor é o 2.
O 2 divide 60, dando 30.
- O 2 divide 30, dando 15.
- O 2 não divide 15 de forma exata.
Por isso, vamos passar ao nosso próximo divisor, o 3.
- O 3 divide 15 de forma exata, dando 5.
- O 3 não divide 5 de forma exata.
O próximo fator possível é o 4.
- O 4 não divide 5 de forma exata.
O próximo fator possível é o 5.
- O 5 divide 5 de forma exata.
- Resta-nos apenas o 1, por isso, agora, terminámos.
Os divisores que resultaram neste cálculo representam a lista dos fatores primos de 60: 2, 2, 3 e 5.
Podes verificar isto por ti:
```text
2 * 2 * 3 * 5
= 4 * 15
= 60
```
Sucesso!
## Source
### Contributed to by
- @behrtam
- @BethanyG
- @cmccandless
- @crsmi
- @Dog
- @ikhadykin
- @kytrinyx
- @lowks
- @N-Parsons
- @pheanex
- @sjakobi
- @subkrish
- @tqa236
### Based on
The Prime Factors Kata by Uncle Bob - https://web.archive.org/web/20221026171801/http://butunclebob.com/ArticleS.UncleBob.ThePrimeFactorsKata
+10
View File
@@ -0,0 +1,10 @@
def factors(value):
prime_factors: list[int] = []
factor: int = 2
while value > 1:
if value % factor == 0:
prime_factors.append(factor)
value //= factor
else:
factor += 1
return prime_factors
@@ -0,0 +1,48 @@
# These tests are auto-generated with test data from:
# https://github.com/exercism/problem-specifications/tree/main/exercises/prime-factors/canonical-data.json
# File last updated on 2026-02-19
import unittest
from prime_factors import (
factors,
)
class PrimeFactorsTest(unittest.TestCase):
def test_no_factors(self):
self.assertEqual(factors(1), [])
def test_prime_number(self):
self.assertEqual(factors(2), [2])
def test_another_prime_number(self):
self.assertEqual(factors(3), [3])
def test_square_of_a_prime(self):
self.assertEqual(factors(9), [3, 3])
def test_product_of_first_prime(self):
self.assertEqual(factors(4), [2, 2])
def test_cube_of_a_prime(self):
self.assertEqual(factors(8), [2, 2, 2])
def test_product_of_second_prime(self):
self.assertEqual(factors(27), [3, 3, 3])
def test_product_of_third_prime(self):
self.assertEqual(factors(625), [5, 5, 5, 5])
def test_product_of_first_and_second_prime(self):
self.assertEqual(factors(6), [2, 3])
def test_product_of_primes_and_non_primes(self):
self.assertEqual(factors(12), [2, 2, 3])
def test_product_of_primes(self):
self.assertEqual(factors(901255), [5, 17, 23, 461])
def test_factors_include_a_large_prime(self):
self.assertEqual(factors(93819012551), [11, 9539, 894119])