{"id":37624389,"url":"https://github.com/douglasfarinelli/pydecker","last_synced_at":"2026-01-16T10:45:40.862Z","repository":{"id":57418024,"uuid":"267486777","full_name":"douglasfarinelli/pydecker","owner":"douglasfarinelli","description":"Simple development tool that simplifies a pythonist's daily tasks.","archived":false,"fork":false,"pushed_at":"2021-02-02T13:12:41.000Z","size":53,"stargazers_count":18,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-08-10T21:30:45.736Z","etag":null,"topics":["code-style","format","python","tool"],"latest_commit_sha":null,"homepage":"https://douglasfarinelli.github.io/pydecker/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/douglasfarinelli.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.d/.gitignore","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-28T03:45:04.000Z","updated_at":"2023-03-15T03:43:34.000Z","dependencies_parsed_at":"2022-09-03T08:51:32.027Z","dependency_job_id":null,"html_url":"https://github.com/douglasfarinelli/pydecker","commit_stats":null,"previous_names":["douglasfarinelli/decker"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/douglasfarinelli/pydecker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasfarinelli%2Fpydecker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasfarinelli%2Fpydecker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasfarinelli%2Fpydecker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasfarinelli%2Fpydecker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/douglasfarinelli","download_url":"https://codeload.github.com/douglasfarinelli/pydecker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasfarinelli%2Fpydecker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-style","format","python","tool"],"created_at":"2026-01-16T10:45:40.228Z","updated_at":"2026-01-16T10:45:40.854Z","avatar_url":"https://github.com/douglasfarinelli.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/douglasfarinelli/decker/blob/main/decker.png\" alt=\"decker\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    Simple development tool that simplifies a pythonist's daily tasks.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pypi.org/project/decker/#history\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://img.shields.io/pypi/status/decker?style=flat\" alt=\"PyPi Status\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://travis-ci.com/douglasfarinelli/decker\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://travis-ci.com/douglasfarinelli/decker.svg\" alt=\"Build Status\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/decker/\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://badge.fury.io/py/decker.svg\" alt=\"Package version\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/decker/\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://img.shields.io/pypi/wheel/decker?style=flat\" alt=\"PyPI - Wheel\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n_Decker_ is a command line, which aims to optimize some tasks, such as configuration and execution of the tools most used by the community.\nIn addition, it aims to reduce configuration files and centralize everything on pyproject.toml.\n\n---\n\n- [Features](#features)\n- [Installation](#installation)\n- [Global Settings](#global-settings)\n- [Extra](#extra)\n- [Next features](#next-features)\n- [License](#license)\n\n--- \n\n## Installation\n\nThe installation of decker can be via `pip`,` pipenv`, `poetry` or any other tool you prefer:\n\n```bash\npipenv install decker\n```\n\n\u003e Note: We recommend installing only on virtualenv.\n\n## Features\n\n```\nWelcome to Decker!\n\n  Simple development tool that simplifies a pythonist's daily tasks.\n\nOptions:\n  --version  Show the version and exit.\n  --help     Show this message and exit.\n\nCommands:\n  format  Run code style format.\n```\n\n### Format your code\n\n```\n  Run code style format.\n\nOptions:\n  --exclude TEXT                  Files and directories that should be\n                                  excluded on recursive searches.\n\n  -l, --line-length INTEGER       How many characters per line to allow.\n                                  [default: 79]\n\n  -b, --backend [autoflake|docformatter|black|unify|isort]\n                                  Specify formatting backends.\n  --help                          Show this message and exit.\n```\n\nFormatting uses several tools, such as: \n\n- [autoflake](https://github.com/myint/autoflake) to remove unusable variables and imports,\n- [docformatter](https://github.com/myint/docformatter) to format docstrings,\n- [black](https://github.com/psf/black) to apply your coding style, format blocks, constants, among other things,\n- [unify](https://github.com/myint/unify) to normalize quotes,\n- And last but not least, [isort](https://github.com/timothycrosley/isort) to reorganize your imports.\n\nTo save and avoid many configurations, decker pre defines some things like:\n\nTool | Option | Pré defined  | Description\n---- | ------ | ------------ | -----------\nautoflake | expand-star-imports | True | Expand wildcard star imports with undefined names\nautoflake | in-place | True | Apply changes\nautoflake | recursive | True | Recursive to defined sources\nautoflake | remove-all-unused-imports | True | Remove all unused imports (not just those from the standard library)\nautoflake | remove-unused-variables | True | \ndocformatter | blank | False | Remove blank line after description\ndocformatter | in-place | True | Apply changes\ndocformatter | make-summary-multi-line | True | Add a newline before and after the summary of a one-line docstring\ndocformatter | pre-summary-newline | True | Add a newline before the summary of a multi-line docstring\ndocformatter | recursive | True | Recursive to defined sources\ndocformatter | wrap-summaries | 79 (from decker global line-length setting) | Wrap long summary lines\nblack | line-length | 79 (from decker global line-length setting) | How many characters per line to allow\nblack | skip-string-normalization | False | Skip string normalization to use unify to normalize\nunify | in-place | True | Apply changes\nunify | quote | \"'\" (Single quote) | \nunify | recursive | True | Recursive to defined sources\nisort | atomic | True | Ensures the output doesn't save if the resulting file contains syntax errors\nisort | case-sensitive | True | Tells isort to include casing when sorting module names\nisort | combine-as | True | Combines as imports on the same line\nisort | line-length | 79 (from decker global line-length setting) | How many characters per line to allow\nisort | lines-after-imports | 2 | \nisort | multi-line | 3 | Multi line output (0-grid, 1-vertical, 2-hanging, 3-vert-hanging, 4-vert-grid, 5-vert-grid-grouped, 6-vert-grid-grouped-no-comma).\nisort | order-by-type | True | Order imports by type in addition to alphabetically\nisort | remove-import | [`__future__`] | Removes the specified import from all files\nisort | skip-glob | `*venv*` | Files that sort imports should skip over\nisort | trailing-comma | True | Includes a trailing comma on multi line imports that include parentheses\nisort | use-parentheses | True | Use parenthesis for line continuation on length limit instead of slashes\n\n\n\u003e Note: Despite pre-defining all these settings, nothing is MANDATORY. All of these and any other configuration of these tools can be adjusted in pyproject.toml or in each configuration file of these tools.\n\n\u003e The intention was to save time for those who already know and help those who do not already know.\n\n\n## Global Settings\n\nTo ensure ease and centralization of the other configurations, decker searches almost all of them in the pyproject.toml file, if any. Example:\n\n```\n[tool.autoflake]\nexpand-star-imports=false\n\n[tool.black]\nline-length=120\n...\n\n[tool.docformatter]\nblank=false\n...\n\n[tool.unify]\nquote='\"'\n...\n\n[tool.isort]\nline-length=120\ntrailing-comma=false\n...\n```\n\n### Decker settings on pyproject.toml\n\nIn addition, there are some that are global, where they are automatically passed on to all tools, such as:\n\n```\n[tool.decker]\nline-length=79\nexclude=same-package\nverbose=1\nsources=src/\n```\n\n### Default sources (src/)\n\nAnd to help as well, if the sources were not defined by the command line or pyproject.toml, decker looks for `.py` files in the directory in question and also for the `src` folder.\n\n## Extra\n\n### pdb++ \u0026 ipython\n\nWhen installing decker, [pdb++](https://github.com/pdbpp/pdbpp) and [ipython](https://github.com/ipython/ipython) are also installed to aid development.\n\n### Better print to pyproject.toml errors \n\nWraps and shows toml errors in a more \"human\" way, for example:\n\n```\n + Unable to load pyproject.toml:\n |   \n |   [project]\n |   author='Douglas Farinelli'\n |   name='decker'\n |   repository='https://gitlab.com/douglasfarinelli/decker/'\n |   \n |   [tool.black]\n |   line-length=79\n |   skip-string-normalization=true\n |   target-version=\n |   \n + ^ Empty value is invalid\n |   \n |   ['py38']\n |   \n |   [tool.isort]\n |   atomic=true\n |   \n |   [tool.towncrier]\n |   package = 'crm'\n |   package_dir = 'src'\n |   filename = 'CHANGELOG.md'\n |   directory = 'changelog.d'\n```\n\n## Next features\n\n- [0.2.0] - Command `decker check`\n\nA command to analyze various things in your code, such as type hints, pep8 and Code quality.\n\n- [0.3.0] - Command `decker release`\n\nWhy not automate the flow VCS + [bumpversion](https://github.com/peritus/bumpversion) + [towncrier](https://github.com/twisted/towncrier)? In other words, automate the generation of tags, changelog and auto-commit them.\n\nExample:\n\n```\ndecker release minor\n```\n\n---\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglasfarinelli%2Fpydecker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdouglasfarinelli%2Fpydecker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglasfarinelli%2Fpydecker/lists"}