Skip to main content

TOPyN: Typed Opinionated PYthon Normalizer

Project description

TOPyN: Typed Opinionated PYthon Normalizer

Actions Status Actions Status Coverage Status License: MIT PyPI

About

Scooter*

Python is quite a flexible language, something that is not so good if you start working in mid level size projects and/or in teams. Over the time we have found a set of rules that makes working with Python in this context easier, and once you get you use to them you want to apply them to every small Python snippet that you write.

The problem is that these rules depend on a set of packages and config files, and every time we change our mind about one rule, or add new ones, we need to update multiple projects. Topyn solves this by providing in one single place all the tools and configurations we use in our projects.

All the configurations are part of the project (topyn/configs) and is not the purpose of this project to make them flexible, if you need that please check the packages that we use, and run them with your configuration.

Install

pip install topyn

Command line

There are two possible arguments:

  • path is the path that you want to check, if it is empty it defaults to the current directory.
  • --fix if you use this flag topyn will try to fix the code for you

Examples

Check the code inside directory_with_code : topyn directory_with_code

Check the code inside current directory : topyn

Check the code inside current directory and try to fix it: topyn --fix

topyn --help output

Typed Opinionated PYthon Normalizer

positional arguments:
  path        path to topynize (default: .)

optional arguments:
  -h, --help  show this help message and exit
  --fix       try to fix my code (default: False)
  --version   show program's version number and exit

topyn output

➡️ Checking formatting ...
All done! ✨ 🍰 ✨
8 files would be left unchanged.
➡️ Checking rules ...
➡️ Checking types ...
✅ Everything is OK! 😎"

🔴

➡️ Checking formatting ...
All done! ✨ 🍰 ✨
1 file would be left unchanged.
➡️ Checking rules ...
➡️ Checking types ...
tests/resources/wrong_types/wrong_types.py:2: error: Incompatible return value type (got "int", expected "str")
Found 1 error in 1 file (checked 1 source file)

🔴 Sadly, types failed 😢

Tools included

Flake8

flake8 is a command-line utility for enforcing style consistency across Python projects

Flake8 plugins

  • flake8-bugbear

    A plugin for flake8 finding likely bugs and design problems in your program. Contains warnings that don't belong in pyflakes and pycodestyle.
  • flake8-print

    Check for print statements in python files.
  • flake8-comprehensions

    A flake8 plugin that helps you write better list/set/dict comprehensions.

Black

The Uncompromising Code Formatter

Mypy

Optional static typing for Python (PEP 484)

Contributors

Leandro Leites Barrios : Main developer

Denada Korita : UX & Documentation consultant


* scooter icon source: icons8

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for topyn, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size topyn-0.2.3-py3-none-any.whl (7.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size topyn-0.2.3.tar.gz (7.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page