=================
Flake8 Spellcheck
=================
|CircleCI| |Black| |PyPi|
Flake8 Plugin that spellchecks variables, functions, classes and other bits of your python code.
You can whitelist words that are specific to your project simply by adding them to ``whitelist.txt``
in the root of your project directory. Each word you add should be separated by a newline.
Spelling is assumed to be in en_US.
This plugin supports python 3.8+
Codes
-----
* SC100 - Spelling error in comments
* SC200 - Spelling error in name (e.g. variable, function, class)
Enable Django support
---------------------
You can enable support for a Django dictionary by adding the following to your
flake8 configuration (e.g. your ``.flake8`` file):
.. code-block:: ini
[flake8]
dictionaries=en_US,python,technical,django
Enable pandas support
---------------------
You can enable support for pandas DataFrames by adding the following to your
flake8 configuration (e.g. your ``.flake8`` file):
.. code-block:: ini
[flake8]
dictionaries=en_US,python,technical,pandas
Specify Targets
---------------
Both ``comments`` and ``names`` (variable names, function names...) are spellchecked by default.
You can specify what targets to spellcheck in your flake8 configuration (e.g. in your ``.flake8`` file):
.. code-block:: ini
[flake8]
spellcheck-targets=comments
The above configuration would only spellcheck comments
.. code-block:: ini
[flake8]
spellcheck-targets=names
The above configuration would only spellcheck names
Contributing
------------
If you have found word(s) which are listed as a spelling error but are actually correct terms used
in python or in technical implementations (e.g. http), then you can very easily contribute by
adding those word(s) to the appropriate dictionaries:
* `python dictionary <flake8_spellcheck/python.txt>`_
* `technical dictionary <flake8_spellcheck/technical.txt>`_
* `django dictionary <flake8_spellcheck/django.txt>`_
* `pandas dictionary <flake8_spellcheck/pandas.txt>`_
Before you submit a PR, it is recommended to run ``check-sorting.sh`` in the root of this repository,
to verify that all the dictionary files are still sorted correctly. Sorting is enforced by CI, so
you'll need to make sure the files are sorted before your PR can be merged.
Developing
----------
* Install `poetry <https://github.com/python-poetry>`__
* Run ``poetry install``
* Install ``pre-commit`` and run ``pre-commit install --install-hooks``
.. |CircleCI| image:: https://circleci.com/gh/MichaelAquilina/flake8-spellcheck.svg?style=svg
:target: https://circleci.com/gh/MichaelAquilina/flake8-spellcheck
.. |PyPi| image:: https://badge.fury.io/py/flake8-spellcheck.svg
:target: https://badge.fury.io/py/flake8-spellcheck
.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
Raw data
{
"_id": null,
"home_page": "https://github.com/MichaelAquilina/flake8-spellcheck",
"name": "flake8-spellcheck",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "lint,spellcheck,flake8",
"author": "Michael Aquilina",
"author_email": "michaelaquilina@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/18/61/a5258e373ba98f2fa01f968881167cb9e92760d44b9c4fd2f8418445799b/flake8-spellcheck-0.28.0.tar.gz",
"platform": null,
"description": "=================\nFlake8 Spellcheck\n=================\n\n|CircleCI| |Black| |PyPi|\n\nFlake8 Plugin that spellchecks variables, functions, classes and other bits of your python code.\n\nYou can whitelist words that are specific to your project simply by adding them to ``whitelist.txt``\nin the root of your project directory. Each word you add should be separated by a newline.\n\nSpelling is assumed to be in en_US.\n\nThis plugin supports python 3.8+\n\nCodes\n-----\n\n* SC100 - Spelling error in comments\n* SC200 - Spelling error in name (e.g. variable, function, class)\n\nEnable Django support\n---------------------\n\nYou can enable support for a Django dictionary by adding the following to your\nflake8 configuration (e.g. your ``.flake8`` file):\n\n.. code-block:: ini\n\n [flake8]\n dictionaries=en_US,python,technical,django\n\nEnable pandas support\n---------------------\n\nYou can enable support for pandas DataFrames by adding the following to your\nflake8 configuration (e.g. your ``.flake8`` file):\n\n.. code-block:: ini\n\n [flake8]\n dictionaries=en_US,python,technical,pandas\n\n\nSpecify Targets\n---------------\n\nBoth ``comments`` and ``names`` (variable names, function names...) are spellchecked by default.\nYou can specify what targets to spellcheck in your flake8 configuration (e.g. in your ``.flake8`` file):\n\n.. code-block:: ini\n\n [flake8]\n spellcheck-targets=comments\n\nThe above configuration would only spellcheck comments\n\n.. code-block:: ini\n\n [flake8]\n spellcheck-targets=names\n\nThe above configuration would only spellcheck names\n\nContributing\n------------\n\nIf you have found word(s) which are listed as a spelling error but are actually correct terms used\nin python or in technical implementations (e.g. http), then you can very easily contribute by\nadding those word(s) to the appropriate dictionaries:\n\n* `python dictionary <flake8_spellcheck/python.txt>`_\n* `technical dictionary <flake8_spellcheck/technical.txt>`_\n* `django dictionary <flake8_spellcheck/django.txt>`_\n* `pandas dictionary <flake8_spellcheck/pandas.txt>`_\n\nBefore you submit a PR, it is recommended to run ``check-sorting.sh`` in the root of this repository,\nto verify that all the dictionary files are still sorted correctly. Sorting is enforced by CI, so\nyou'll need to make sure the files are sorted before your PR can be merged.\n\nDeveloping\n----------\n\n* Install `poetry <https://github.com/python-poetry>`__\n* Run ``poetry install``\n* Install ``pre-commit`` and run ``pre-commit install --install-hooks``\n\n\n.. |CircleCI| image:: https://circleci.com/gh/MichaelAquilina/flake8-spellcheck.svg?style=svg\n :target: https://circleci.com/gh/MichaelAquilina/flake8-spellcheck\n\n.. |PyPi| image:: https://badge.fury.io/py/flake8-spellcheck.svg\n :target: https://badge.fury.io/py/flake8-spellcheck\n\n.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Spellcheck variables, comments and docstrings",
"version": "0.28.0",
"project_urls": {
"Homepage": "https://github.com/MichaelAquilina/flake8-spellcheck",
"Repository": "https://github.cim/MichaelAquilina/flake8-spellcheck"
},
"split_keywords": [
"lint",
"spellcheck",
"flake8"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1c0617debcfce46c197e5158177aa2b076bc4fdf2f189d64272dc553b33018b5",
"md5": "bccf6e85818e7765b009310e4f4c8f2e",
"sha256": "a0a37164b9175819b143ce0f0a8d2475457af3f0d77cd8423b0daf204662ee72"
},
"downloads": -1,
"filename": "flake8_spellcheck-0.28.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bccf6e85818e7765b009310e4f4c8f2e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 333527,
"upload_time": "2022-03-27T18:55:48",
"upload_time_iso_8601": "2022-03-27T18:55:48.918467Z",
"url": "https://files.pythonhosted.org/packages/1c/06/17debcfce46c197e5158177aa2b076bc4fdf2f189d64272dc553b33018b5/flake8_spellcheck-0.28.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1861a5258e373ba98f2fa01f968881167cb9e92760d44b9c4fd2f8418445799b",
"md5": "7514050c38ac1c006992316a71e4d887",
"sha256": "6fb79724f27097af0b4c678c7eaf731f0d87cf4c1eae7fbd7836c1c78d67e12c"
},
"downloads": -1,
"filename": "flake8-spellcheck-0.28.0.tar.gz",
"has_sig": false,
"md5_digest": "7514050c38ac1c006992316a71e4d887",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 334362,
"upload_time": "2022-03-27T18:55:47",
"upload_time_iso_8601": "2022-03-27T18:55:47.450444Z",
"url": "https://files.pythonhosted.org/packages/18/61/a5258e373ba98f2fa01f968881167cb9e92760d44b9c4fd2f8418445799b/flake8-spellcheck-0.28.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-03-27 18:55:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MichaelAquilina",
"github_project": "flake8-spellcheck",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"circle": true,
"lcname": "flake8-spellcheck"
}
JSON
