?? A UCRÂNIA ESTÁ SENDO ATACADA PELO EXÉRCITO RUSSO. CIVIS ESTÃO SENDO MORTOS. ÁREAS RESIDENCIAIS ESTÃO SENDO BOMBARDADAS.
- Ajude a Ucrânia através de:
- Fundação de Caridade Serhiy Prytula
- Fundação de caridade Come Back Alive
- Banco Nacional da Ucrânia
- Mais informações sobre war.ukraine.ua e MFA da Ucrânia
Esta é uma coleção de scripts Python divididos por tópicos e contém exemplos de código com explicações, diferentes casos de uso e links para leituras adicionais.
Leia isto em: Português , Español , Chinês Tradicional .
É um playground porque você pode alterar ou adicionar o código para ver como funciona e testá-lo usando asserções. Ele também permite que você lint o código que você escreveu e verifique se ele se ajusta ao guia de estilo de código Python. Ao todo, isso pode tornar seu processo de aprendizagem mais interativo e pode ajudá-lo a manter a qualidade do código bastante alta desde o início.
É uma folha de dicas porque você pode voltar a esses exemplos de código quando quiser recapitular a sintaxe das instruções e construções padrão do Python. Além disso, como o código está cheio de asserções, você poderá ver a saída esperada das funções/instruções imediatamente, sem iniciá-las.
Você também pode estar interessado em? Experimentos interativos de aprendizado de máquina
Cada script Python neste repositório possui a seguinte estrutura:
"""Lists <--- Name of the topic here
# @see: https://www.learnpython.org/en/Lists <-- Link to further readings goes here
Here might go more detailed explanation of the current topic (i.e. general info about Lists).
"""
def test_list_type ():
"""Explanation of sub-topic goes here.
Each file contains test functions that illustrate sub-topics (i.e. lists type, lists methods).
"""
# Here is an example of how to build a list. <-- Comments here explain the action
squares = [ 1 , 4 , 9 , 16 , 25 ]
# Lists can be indexed and sliced.
# Indexing returns the item.
assert squares [ 0 ] == 1 # <-- Assertions here illustrate the result.
# Slicing returns a new list.
assert squares [ - 3 :] == [ 9 , 16 , 25 ] # <-- Assertions here illustrate the result.
Então normalmente você pode querer fazer o seguinte:
+
, -
, *
, /
, //
, %
, **
)&
, |
, ^
, >>
, <<
, ~
)=
, +=
, -=
, /=
, //=
etc.)==
, !=
, >
, <
, >=
, <=
)and
, or
, not
)is
, is not
)in
, not in
)if
for
(e a função range()
)while
try
break
continue
def
e return
)global
e nonlocal
)*
e **
)lambda
)class
)import
)try
)raise
)with
declaração)pass
yield
)json
)glob
)re
biblioteca)math
, random
, bibliotecas statistics
)datetime
)zlib
)input
) Instalando Python
Certifique-se de ter o Python3 instalado em sua máquina.
Você pode querer usar a biblioteca Python padrão venv para criar ambientes virtuais e ter Python, pip e todos os pacotes dependentes para serem instalados e servidos a partir do diretório local do projeto para evitar mexer com pacotes de todo o sistema e suas versões.
Dependendo da sua instalação, você pode ter acesso ao interpretador Python3 executando python
ou python3
. O mesmo vale para o gerenciador de pacotes pip - ele pode ser acessado executando pip
ou pip3
.
Você pode verificar sua versão do Python executando:
python --version
Observe que neste repositório sempre que você vir python
será assumido que é Python 3 .
Instalando dependências
Instale todas as dependências necessárias para o projeto executando:
pip install -r requirements.txt
Os testes são feitos usando o framework pytest.
Você pode adicionar novos testes adicionando arquivos e funções com o prefixo test_
(ou seja, test_topic.py
com a função def test_sub_topic()
dentro).
Para executar todos os testes, execute o seguinte comando na pasta raiz do projeto:
pytest
Para executar testes específicos, execute:
pytest ./path/to/the/test_file.py
Linting é feito usando bibliotecas pylint e flake8.
Para verificar se o código está escrito de acordo com o guia de estilo PEP 8, execute:
pylint ./src/
Caso o linter detecte um erro (ou seja, missing-docstring
), você pode querer ler mais sobre erros específicos executando:
pylint --help-msg=missing-docstring
Mais sobre PyLint
Para verificar se o código está escrito de acordo com o guia de estilo PEP 8, execute:
flake8 ./src
Ou se quiser uma saída mais detalhada, você pode executar:
flake8 ./src --statistics --show-source --count
Mais sobre Flake8