{"id":37069893,"url":"https://github.com/venthur/noir","last_synced_at":"2026-01-14T08:03:01.571Z","repository":{"id":35074667,"uuid":"203539692","full_name":"venthur/noir","owner":"venthur","description":"The uncompromising Python code formatter","archived":false,"fork":true,"pushed_at":"2023-03-06T20:15:56.000Z","size":5978,"stargazers_count":2,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-28T11:57:44.970Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://black.readthedocs.io/en/stable/","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"psf/black","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/venthur.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-21T08:22:24.000Z","updated_at":"2023-01-31T17:30:49.000Z","dependencies_parsed_at":"2023-01-16T23:01:18.462Z","dependency_job_id":null,"html_url":"https://github.com/venthur/noir","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/venthur/noir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venthur%2Fnoir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venthur%2Fnoir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venthur%2Fnoir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venthur%2Fnoir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/venthur","download_url":"https://codeload.github.com/venthur/noir/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venthur%2Fnoir/sbom","scorecard":{"id":918581,"data":{"date":"2025-08-11","repo":{"name":"github.com/venthur/noir","commit":"2eee76e57d11ec28442eaa55a8554891864be327"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/changelog.yml:1","Warn: no topLevel permission defined: .github/workflows/diff_shades.yml:1","Warn: no topLevel permission defined: .github/workflows/doc.yml:1","Warn: no topLevel permission defined: .github/workflows/docker.yml:1","Warn: no topLevel permission defined: .github/workflows/fuzz.yml:1","Warn: no topLevel permission defined: .github/workflows/lint.yml:1","Warn: no topLevel permission defined: .github/workflows/pypi_upload.yml:1","Warn: no topLevel permission defined: .github/workflows/test.yml:1","Warn: no topLevel permission defined: .github/workflows/upload_binary.yml:1","Warn: no topLevel permission defined: .github/workflows/uvloop_test.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":10,"reason":"project is fuzzed","details":["Info: PythonAtherisFuzzer integration found: fuzz.py:81"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":9,"reason":"1 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2022-43017 / GHSA-qwmp-2cf2-g9g6"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/changelog.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/changelog.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:73: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:113: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:119: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:125: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades.yml:140: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades_comment.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades_comment.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/diff_shades_comment.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/diff_shades_comment.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/doc.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/doc.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/doc.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/doc.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docker.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/docker.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/fuzz.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/fuzz.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/fuzz.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/fuzz.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/lint.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lint.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/lint.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lint.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/lint.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi_upload.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/pypi_upload.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi_upload.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/pypi_upload.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/test.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:61: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:77: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/test.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:79: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/upload_binary.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/upload_binary.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/upload_binary.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/upload_binary.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/upload_binary.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/upload_binary.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/uvloop_test.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/uvloop_test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/uvloop_test.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/venthur/noir/uvloop_test.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1","Warn: containerImage not pinned by hash: Dockerfile:11: pin your Docker image by updating python:3-slim to python:3-slim@sha256:4d55aff3915a8622fdb8e6ab3645992de771bd97c3dd1279860cd5e18bcd7582","Warn: containerImage not pinned by hash: gallery/Dockerfile:1: pin your Docker image by updating python:3.8.2-slim to python:3.8.2-slim@sha256:ed48f14994a6de2240f0b3a491f75a78b491010b45c1cfa16273022ae5408c61","Warn: pipCommand not pinned by hash: Dockerfile:5-9","Warn: pipCommand not pinned by hash: Dockerfile:5-9","Warn: pipCommand not pinned by hash: .github/workflows/diff_shades.yml:53","Warn: pipCommand not pinned by hash: .github/workflows/diff_shades.yml:54","Warn: pipCommand not pinned by hash: .github/workflows/diff_shades.yml:55","Warn: pipCommand not pinned by hash: .github/workflows/diff_shades.yml:56","Warn: pipCommand not pinned by hash: .github/workflows/diff_shades_comment.yml:20","Warn: pipCommand not pinned by hash: .github/workflows/diff_shades_comment.yml:21","Warn: pipCommand not pinned by hash: .github/workflows/doc.yml:28","Warn: pipCommand not pinned by hash: .github/workflows/doc.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/doc.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/fuzz.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/fuzz.yml:31","Warn: pipCommand not pinned by hash: .github/workflows/lint.yml:24","Warn: pipCommand not pinned by hash: .github/workflows/lint.yml:25","Warn: pipCommand not pinned by hash: .github/workflows/pypi_upload.yml:20","Warn: pipCommand not pinned by hash: .github/workflows/pypi_upload.yml:21","Warn: pipCommand not pinned by hash: .github/workflows/test.yml:40","Warn: pipCommand not pinned by hash: .github/workflows/test.yml:41","Warn: pipCommand not pinned by hash: .github/workflows/upload_binary.yml:38","Warn: pipCommand not pinned by hash: .github/workflows/upload_binary.yml:39","Warn: pipCommand not pinned by hash: .github/workflows/upload_binary.yml:40","Warn: pipCommand not pinned by hash: .github/workflows/uvloop_test.yml:37","Warn: pipCommand not pinned by hash: .github/workflows/uvloop_test.yml:41","Info:   0 out of  27 GitHub-owned GitHubAction dependencies pinned","Info:   2 out of  10 third-party GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned","Info:   2 out of  26 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}}]},"last_synced_at":"2025-08-24T23:07:25.430Z","repository_id":35074667,"created_at":"2025-08-24T23:07:25.430Z","updated_at":"2025-08-24T23:07:25.430Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28413527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-01-14T08:03:00.874Z","updated_at":"2026-01-14T08:03:01.558Z","avatar_url":"https://github.com/venthur.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Why Noir?\n\nNoir is a drop-in replacement for Black with a default line length set to 79\ncharacters.\n\nTo replace black you only need to replace `black` with `noir` in the\nrequirements.txt and/or setup.py.\n\nNoir provides the binary `black` so you don't have to change anything else in\nyour build pipeline.\n\n![Black Logo](https://raw.githubusercontent.com/psf/black/main/docs/_static/logo2-readme.png)\n\n\u003ch2 align=\"center\"\u003eThe Uncompromising Code Formatter\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/psf/black/actions\"\u003e\u003cimg alt=\"Actions Status\" src=\"https://github.com/psf/black/workflows/Test/badge.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://black.readthedocs.io/en/stable/?badge=stable\"\u003e\u003cimg alt=\"Documentation Status\" src=\"https://readthedocs.org/projects/black/badge/?version=stable\"\u003e\u003c/a\u003e\n\u003ca href=\"https://coveralls.io/github/psf/black?branch=main\"\u003e\u003cimg alt=\"Coverage Status\" src=\"https://coveralls.io/repos/github/psf/black/badge.svg?branch=main\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/psf/black/blob/main/LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://black.readthedocs.io/en/stable/_static/license.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/black/\"\u003e\u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/black\"\u003e\u003c/a\u003e\n\u003ca href=\"https://pepy.tech/project/black\"\u003e\u003cimg alt=\"Downloads\" src=\"https://pepy.tech/badge/black\"\u003e\u003c/a\u003e\n\u003ca href=\"https://anaconda.org/conda-forge/black/\"\u003e\u003cimg alt=\"conda-forge\" src=\"https://img.shields.io/conda/dn/conda-forge/black.svg?label=conda-forge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e “Any color you like.”\n\n_Black_ is the uncompromising Python code formatter. By using it, you agree to cede\ncontrol over minutiae of hand-formatting. In return, _Black_ gives you speed,\ndeterminism, and freedom from `pycodestyle` nagging about formatting. You will save time\nand mental energy for more important matters.\n\nBlackened code looks the same regardless of the project you're reading. Formatting\nbecomes transparent after a while and you can focus on the content instead.\n\n_Black_ makes code review faster by producing the smallest diffs possible.\n\nTry it out now using the [Black Playground](https://black.vercel.app). Watch the\n[PyCon 2019 talk](https://youtu.be/esZLCuWs_2Y) to learn more.\n\n---\n\n**[Read the documentation on ReadTheDocs!](https://black.readthedocs.io/en/stable)**\n\n---\n\n## Installation and usage\n\n### Installation\n\n_Black_ can be installed by running `pip install black`. It requires Python 3.6.2+ to\nrun. If you want to format Jupyter Notebooks, install with `pip install black[jupyter]`.\n\nIf you can't wait for the latest _hotness_ and want to install from GitHub, use:\n\n`pip install git+https://github.com/psf/black`\n\n### Usage\n\nTo get started right away with sensible defaults:\n\n```sh\nblack {source_file_or_directory}\n```\n\nYou can run _Black_ as a package if running it as a script doesn't work:\n\n```sh\npython -m black {source_file_or_directory}\n```\n\nFurther information can be found in our docs:\n\n- [Usage and Configuration](https://black.readthedocs.io/en/stable/usage_and_configuration/index.html)\n\n_Black_ is already [successfully used](https://github.com/psf/black#used-by) by many\nprojects, small and big. _Black_ has a comprehensive test suite, with efficient parallel\ntests, and our own auto formatting and parallel Continuous Integration runner. Now that\nwe have become stable, you should not expect large formatting to changes in the future.\nStylistic changes will mostly be responses to bug reports and support for new Python\nsyntax. For more information please refer to the\n[The Black Code Style](docs/the_black_code_style/index.rst).\n\nAlso, as a safety measure which slows down processing, _Black_ will check that the\nreformatted code still produces a valid AST that is effectively equivalent to the\noriginal (see the\n[Pragmatism](https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html#ast-before-and-after-formatting)\nsection for details). If you're feeling confident, use `--fast`.\n\n## The _Black_ code style\n\n_Black_ is a PEP 8 compliant opinionated formatter. _Black_ reformats entire files in\nplace. Style configuration options are deliberately limited and rarely added. It doesn't\ntake previous formatting into account (see [Pragmatism](#pragmatism) for exceptions).\n\nOur documentation covers the current _Black_ code style, but planned changes to it are\nalso documented. They're both worth taking a look:\n\n- [The _Black_ Code Style: Current style](https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html)\n- [The _Black_ Code Style: Future style](https://black.readthedocs.io/en/stable/the_black_code_style/future_style.html)\n\nPlease refer to this document before submitting an issue. What seems like a bug might be\nintended behaviour.\n\n### Pragmatism\n\nEarly versions of _Black_ used to be absolutist in some respects. They took after its\ninitial author. This was fine at the time as it made the implementation simpler and\nthere were not many users anyway. Not many edge cases were reported. As a mature tool,\n_Black_ does make some exceptions to rules it otherwise holds.\n\n- [The _Black_ code style: Pragmatism](https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html#pragmatism)\n\nPlease refer to this document before submitting an issue just like with the document\nabove. What seems like a bug might be intended behaviour.\n\n## Configuration\n\n_Black_ is able to read project-specific default values for its command line options\nfrom a `pyproject.toml` file. This is especially useful for specifying custom\n`--include` and `--exclude`/`--force-exclude`/`--extend-exclude` patterns for your\nproject.\n\nYou can find more details in our documentation:\n\n- [The basics: Configuration via a file](https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html#configuration-via-a-file)\n\nAnd if you're looking for more general configuration documentation:\n\n- [Usage and Configuration](https://black.readthedocs.io/en/stable/usage_and_configuration/index.html)\n\n**Pro-tip**: If you're asking yourself \"Do I need to configure anything?\" the answer is\n\"No\". _Black_ is all about sensible defaults. Applying those defaults will have your\ncode in compliance with many other _Black_ formatted projects.\n\n## Used by\n\nThe following notable open-source projects trust _Black_ with enforcing a consistent\ncode style: pytest, tox, Pyramid, Django Channels, Hypothesis, attrs, SQLAlchemy,\nPoetry, PyPA applications (Warehouse, Bandersnatch, Pipenv, virtualenv), pandas, Pillow,\nTwisted, LocalStack, every Datadog Agent Integration, Home Assistant, Zulip, Kedro,\nOpenOA, FLORIS, ORBIT, WOMBAT, and many more.\n\nThe following organizations use _Black_: Facebook, Dropbox, KeepTruckin, Mozilla, Quora,\nDuolingo, QuantumBlack, Tesla.\n\nAre we missing anyone? Let us know.\n\n## Testimonials\n\n**Mike Bayer**, [author of `SQLAlchemy`](https://www.sqlalchemy.org/):\n\n\u003e I can't think of any single tool in my entire programming career that has given me a\n\u003e bigger productivity increase by its introduction. I can now do refactorings in about\n\u003e 1% of the keystrokes that it would have taken me previously when we had no way for\n\u003e code to format itself.\n\n**Dusty Phillips**,\n[writer](https://smile.amazon.com/s/ref=nb_sb_noss?url=search-alias%3Daps\u0026field-keywords=dusty+phillips):\n\n\u003e _Black_ is opinionated so you don't have to be.\n\n**Hynek Schlawack**, [creator of `attrs`](https://www.attrs.org/), core developer of\nTwisted and CPython:\n\n\u003e An auto-formatter that doesn't suck is all I want for Xmas!\n\n**Carl Meyer**, [Django](https://www.djangoproject.com/) core developer:\n\n\u003e At least the name is good.\n\n**Kenneth Reitz**, creator of [`requests`](http://python-requests.org/) and\n[`pipenv`](https://readthedocs.org/projects/pipenv/):\n\n\u003e This vastly improves the formatting of our code. Thanks a ton!\n\n## Show your style\n\nUse the badge in your project's README.md:\n\n```md\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n```\n\nUsing the badge in README.rst:\n\n```\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n```\n\nLooks like this:\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n## License\n\nMIT\n\n## Contributing\n\nWelcome! Happy to see you willing to make the project better. You can get started by\nreading this:\n\n- [Contributing: The basics](https://black.readthedocs.io/en/latest/contributing/the_basics.html)\n\nYou can also take a look at the rest of the contributing docs or talk with the\ndevelopers:\n\n- [Contributing documentation](https://black.readthedocs.io/en/latest/contributing/index.html)\n- [Chat on Discord](https://discord.gg/RtVdv86PrH)\n\n## Change log\n\nThe log has become rather long. It moved to its own file.\n\nSee [CHANGES](https://black.readthedocs.io/en/latest/change_log.html).\n\n## Authors\n\nThe author list is quite long nowadays, so it lives in its own file.\n\nSee [AUTHORS.md](./AUTHORS.md)\n\n## Code of Conduct\n\nEveryone participating in the _Black_ project, and in particular in the issue tracker,\npull requests, and social media activity, is expected to treat other people with respect\nand more generally to follow the guidelines articulated in the\n[Python Community Code of Conduct](https://www.python.org/psf/codeofconduct/).\n\nAt the same time, humor is encouraged. In fact, basic familiarity with Monty Python's\nFlying Circus is expected. We are not savages.\n\nAnd if you _really_ need to slap somebody, do it with a fish while dancing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fventhur%2Fnoir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fventhur%2Fnoir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fventhur%2Fnoir/lists"}