{"author":null,"author_email":"Lucas De Marchi ","bugtrack_url":null,"classifiers":["Intended Audience :: Developers","License :: OSI Approved","Operating System :: MacOS","Operating System :: Microsoft :: Windows","Operating System :: POSIX","Operating System :: Unix","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Topic :: Software Development"],"description":"codespell\n=========\n\nFix common misspellings in text files. It's designed primarily for checking\nmisspelled words in source code (backslash escapes are skipped), but it can be used with other files as well.\nIt does not check for word membership in a complete dictionary, but instead\nlooks for a set of common misspellings. Therefore it should catch errors like\n\"adn\", but it will not catch \"adnasdfasdf\". This also means it shouldn't\ngenerate false-positives when you use a niche term it doesn't know about.\n\nUseful links\n------------\n\n* `GitHub project `_\n\n* `Repository `_\n\n* `Releases `_\n\nRequirements\n------------\n\nPython 3.8 or above.\n\nInstallation\n------------\n\nYou can use ``pip`` to install codespell with e.g.:\n\n.. code-block:: sh\n\n pip install codespell\n\nUsage\n-----\n\nBelow are some simple usage examples to demonstrate how the tool works.\nFor exhaustive usage information, please check the output of ``codespell -h``.\n\nRun codespell in all files of the current directory:\n\n.. code-block:: sh\n\n codespell\n\nRun codespell in specific files or directories (specified via their names or glob patterns):\n\n.. code-block:: sh\n\n codespell some_file some_dir/ *.ext\n\nSome noteworthy flags:\n\n.. code-block:: sh\n\n codespell -w, --write-changes\n\nThe ``-w`` flag will actually implement the changes recommended by codespell. Running without the ``-w`` flag is the same as doing a dry run. It is recommended to run this with the ``-i`` or ``--interactive`` flag.\n\n.. code-block:: sh\n\n codespell -I FILE, --ignore-words=FILE\n\nThe ``-I`` flag can be used for a list of certain words to allow that are in the codespell dictionaries. The format of the file is one word per line. Invoke using: ``codespell -I path/to/file.txt`` to execute codespell referencing said list of allowed words. See `Ignoring Words`_ for more details.\n\n.. code-block:: sh\n\n codespell -L word1,word2,word3,word4\n\nThe ``-L`` flag can be used to allow certain words that are comma-separated placed immediately after it. See `Ignoring Words`_ for more details.\n\n.. code-block:: sh\n\n codespell -x FILE, --exclude-file=FILE\n\nIgnore whole lines that match those in ``FILE``. The lines in ``FILE`` should match the to-be-excluded lines exactly.\n\n.. code-block:: sh\n\n codespell -S, --skip=\n\nComma-separated list of files to skip. It accepts globs as well. Examples:\n\n* to skip .eps & .txt files, invoke ``codespell --skip=\"*.eps,*.txt\"``\n\n* to skip directories, invoke ``codespell --skip=\"./src/3rd-Party,./src/Test\"``\n\n\nUseful commands:\n\n.. code-block:: sh\n\n codespell -d -q 3 --skip=\"*.po,*.ts,./src/3rdParty,./src/Test\"\n\nList all typos found except translation files and some directories.\nDisplay them without terminal colors and with a quiet level of 3.\n\n.. code-block:: sh\n\n codespell -i 3 -w\n\nRun interactive mode level 3 and write changes to file.\n\nWe ship a collection of dictionaries that are an improved version of the one available\n`on Wikipedia `_\nafter applying them in projects like Linux Kernel, EFL, oFono among others.\nYou can provide your own version of the dictionary, but patches for\nnew/different entries are very welcome.\n\nWant to know if a word you're proposing exists in codespell already? It is possible to test a word against the current set dictionaries that exist in ``codespell_lib/data/dictionary*.txt`` via:\n\n.. code-block:: sh\n\n echo \"word\" | codespell -\n echo \"1stword,2ndword\" | codespell -\n\nYou can select the optional dictionaries with the ``--builtin`` option.\n\nIgnoring words\n--------------\n\nWhen ignoring false positives, note that spelling errors are *case-insensitive* but words to ignore are *case-sensitive*. For example, the dictionary entry ``wrod`` will also match the typo ``Wrod``, but to ignore it you must pass ``Wrod``.\n\nThe words to ignore can be passed in two ways:\n\n1. ``-I``: A file with a word per line to ignore:\n\n .. code-block:: sh\n\n codespell -I FILE, --ignore-words=FILE\n\n2. ``-L``: A comma separated list of words to ignore on the command line:\n\n .. code-block:: sh\n\n codespell -L word1,word2,word3,word4\n\nInline ignore\n-------------\n\nSome situation might require ignoring a specific word in a specific location. This can be achieved by adding a comment in the source code.\nYou can either ignore a single word or a list of words. The comment should be in the format of ``codespell:ignore ``.\nWords should be separated by a comma.\n\n1. ignore specific word:\n\n .. code-block:: python\n\n def wrod() # codespell:ignore wrod\n pass\n\n2. ignore multiple words:\n\n .. code-block:: python\n\n def wrod(wrods) # codespell:ignore\n pass\n\nUsing a config file\n-------------------\n\nCommand line options can also be specified in a config file.\n\nWhen running ``codespell``, it will check in the current directory for an\n`INI file `_\nnamed ``setup.cfg`` or ``.codespellrc`` (or a file specified via ``--config``),\ncontaining an entry named ``[codespell]``. Each command line argument can\nbe specified in this file (without the preceding dashes), for example:\n\n.. code-block:: ini\n\n [codespell]\n skip = *.po,*.ts,./src/3rdParty,./src/Test\n count =\n quiet-level = 3\n\nPython's\n`configparser `_\nmodule defines the exact format of INI config files. For example,\ncomments are possible using ``;`` or ``#`` as the first character.\n\nCodespell will also check in the current directory for a ``pyproject.toml``\nfile (or a file specified via ``--toml``), and the ``[tool.codespell]``\nentry will be used. For versions of Python prior to 3.11, this requires\nthe tomli_ package. For example, here is the TOML equivalent of the\nprevious config file:\n\n.. code-block:: toml\n\n [tool.codespell]\n skip = '*.po,*.ts,./src/3rdParty,./src/Test'\n count = true\n quiet-level = 3\n\nThe above INI and TOML files are equivalent to running:\n\n.. code-block:: sh\n\n codespell --skip \"*.po,*.ts,./src/3rdParty,./src/Test\" --count --quiet-level 3\n\nIf several config files are present, they are read in the following order:\n\n#. ``pyproject.toml`` (only if the ``tomli`` library is available for Python < 3.11)\n#. ``setup.cfg``\n#. ``.codespellrc``\n#. any additional file supplied via ``--config``\n\nIf a codespell configuration is supplied in several of these files,\nthe configuration from the most recently read file overwrites previously\nspecified configurations. Any options specified in the command line will\n*override* options from the config files.\n\nValues in a config file entry cannot start with a ``-`` character, so if\nyou need to do this, structure your entries like this:\n\n.. code-block:: ini\n\n [codespell]\n dictionary = mydict,-\n ignore-words-list = bar,-foo\n\ninstead of these invalid entries:\n\n.. code-block:: ini\n\n [codespell]\n dictionary = -,mydict\n ignore-words-list = -foo,bar\n\n.. _tomli: https://pypi.org/project/tomli/\n\npre-commit hook\n---------------\n\ncodespell also works with `pre-commit `_, using\n\n.. code-block:: yaml\n\n - repo: https://github.com/codespell-project/codespell\n rev: v2.2.4\n hooks:\n - id: codespell\n\nIf one configures codespell using the `pyproject.toml` file instead use:\n\n.. code-block:: yaml\n\n - repo: https://github.com/codespell-project/codespell\n rev: v2.2.4\n hooks:\n - id: codespell\n additional_dependencies:\n - tomli\n\nDictionary format\n-----------------\n\nThe format of the dictionaries was influenced by the one they originally came from,\ni.e. from Wikipedia. The difference is how multiple options are treated and\nthat the last argument is an optional reason why a certain entry could not be\napplied directly, but should instead be manually inspected. E.g.:\n\n1. Simple entry: one wrong word / one suggestion::\n\n calulated->calculated\n\n2. Entry with more than one suggested fix::\n\n fiel->feel, field, file, phial,\n\n Note the last comma! You need to use it, otherwise the last suggestion\n will be discarded (see below for why). When there is more than one\n suggestion, an automatic fix is not possible and the best we can do is\n to give the user the file and line where the error occurred as well as\n the suggestions.\n\n3. Entry with one word, but with automatic fix disabled::\n\n clas->class, disabled because of name clash in c++\n\n Note that there isn't a comma at the end of the line. The last argument is\n treated as the reason why a suggestion cannot be automatically applied.\n\n There can also be multiple suggestions but any automatic fix will again be\n disabled::\n\n clas->class, clash, disabled because of name clash in c++\n\nDevelopment setup\n-----------------\n\nAs suggested in the `Python Packaging User Guide`_, ensure ``pip``, ``setuptools``, and ``wheel`` are up to date before installing from source. Specifically you will need recent versions of ``setuptools`` and ``setuptools_scm``:\n\n.. code-block:: sh\n\n pip install --upgrade pip setuptools setuptools_scm wheel\n\nYou can install required dependencies for development by running the following within a checkout of the codespell source:\n\n.. code-block:: sh\n\n pip install -e \".[dev]\"\n\nTo run tests against the codebase run:\n\n.. code-block:: sh\n\n make check\n\n.. _Python Packaging User Guide: https://packaging.python.org/en/latest/tutorials/installing-packages/#requirements-for-installing-packages\n\nSending pull requests\n---------------------\n\nIf you have a suggested typo that you'd like to see merged please follow these steps:\n\n1. Make sure you read the instructions mentioned in the ``Dictionary format`` section above to submit correctly formatted entries.\n\n2. Choose the correct dictionary file to add your typo to. See `codespell --help` for explanations of the different dictionaries.\n\n3. Sort the dictionaries. This is done by invoking (in the top level directory of ``codespell/``):\n\n .. code-block:: sh\n\n make check-dictionaries\n\n If the make script finds that you need to sort a dictionary, please then run:\n\n .. code-block:: sh\n\n make sort-dictionaries\n\n4. Only after this process is complete do we recommend you submit the PR.\n\n**Important Notes:**\n\n* If the dictionaries are submitted without being pre-sorted the PR will fail via our various CI tools.\n* Not all PRs will be merged. This is pending on the discretion of the devs, maintainers, and the community.\n\nUpdating\n--------\n\nTo stay current with codespell developments it is possible to build codespell from GitHub via:\n\n.. code-block:: sh\n\n pip install --upgrade git+https://github.com/codespell-project/codespell.git\n\n**Important Notes:**\n\n* Sometimes installing via ``pip`` will complain about permissions. If this is the case then run with:\n\n .. code-block:: sh\n\n pip install --user --upgrade git+https://github.com/codespell-project/codespell.git\n\n* It has been reported that after installing from ``pip``, codespell can't be located. Please check the $PATH variable to see if ``~/.local/bin`` is present. If it isn't then add it to your path.\n* If you decide to install via ``pip`` then be sure to remove any previously installed versions of codespell (via your platform's preferred app manager).\n\nUpdating the dictionaries\n-------------------------\n\nIn the scenario where the user prefers not to follow the development version of codespell yet still opts to benefit from the frequently updated dictionary files, we recommend running a simple set of commands to achieve this:\n\n.. code-block:: sh\n\n wget https://raw.githubusercontent.com/codespell-project/codespell/main/codespell_lib/data/dictionary.txt\n codespell -D dictionary.txt\n\nThe above simply downloads the latest ``dictionary.txt`` file and then by utilizing the ``-D`` flag allows the user to specify the freshly downloaded ``dictionary.txt`` as the custom dictionary instead of the default one.\n\nYou can also do the same thing for the other dictionaries listed here:\n https://github.com/codespell-project/codespell/tree/main/codespell_lib/data\n\nLicense\n-------\n\nThe Python script ``codespell`` with its library ``codespell_lib`` is available\nwith the following terms:\n(*tl;dr*: `GPL v2`_)\n\n Copyright (C) 2010-2011 Lucas De Marchi \n\n Copyright (C) 2011 ProFUSION embedded systems\n\n This program is free software; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; version 2 of the License.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program; if not, see\n .\n\n.. _GPL v2: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html\n\n``dictionary.txt`` and the other ``dictionary_*.txt`` files are derivative works of English Wikipedia and are released under the `Creative Commons Attribution-Share-Alike License 3.0 `_.\n","description_content_type":"text/x-rst","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":null,"license":"GPL-2.0-only","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"codespell","package_url":"https://pypi.org/project/codespell/","platform":null,"project_url":"https://pypi.org/project/codespell/","project_urls":{"homepage":"https://github.com/codespell-project/codespell","repository":"https://github.com/codespell-project/codespell"},"provides_extra":["dev","hard-encoding-detection","toml","types"],"release_url":"https://pypi.org/project/codespell/2.4.1/","requires_dist":["build; extra == \"dev\"","chardet; extra == \"dev\"","pre-commit; extra == \"dev\"","pytest; extra == \"dev\"","pytest-cov; extra == \"dev\"","pytest-dependency; extra == \"dev\"","Pygments; extra == \"dev\"","ruff; extra == \"dev\"","tomli; extra == \"dev\"","twine; extra == \"dev\"","chardet; extra == \"hard-encoding-detection\"","tomli; python_version < \"3.11\" and extra == \"toml\"","chardet>=5.1.0; extra == \"types\"","mypy; extra == \"types\"","pytest; extra == \"types\"","pytest-cov; extra == \"types\"","pytest-dependency; extra == \"types\""],"requires_python":">=3.8","summary":"Fix common misspellings in text files","version":"2.4.1","yanked":false,"yanked_reason":null}

Dependency	Optional
build	true
chardet	true
mypy	true
pre-commit	true
Pygments	true
pytest	true
pytest-cov	true
pytest-dependency	true
ruff	true
tomli	true
twine	true

Package search

codespell

project_urls

Dependencies

All package metadata

Releases