Skip to main content

Lint Cython files

Project description

Build Status Coverage pre-commit.ci status

cython-lint

Everything flake8 used to do (by accident), plus much more.

A tool and pre-commit hook to lint Cython files.

Used by

Here's some major projects using cython-lint - is yours missing? Feel free to open a pull request!

Installation

$ pip install cython-lint

Usage as a pre-commit hook

See pre-commit for instructions

Sample .pre-commit-config.yaml:

-   repo: https://github.com/MarcoGorelli/cython-lint
    rev: v0.16.2
    hooks:
    -   id: cython-lint
    -   id: double-quote-cython-strings

Command-line example

$ cython-lint my_file_1.pyx my_file_2.pyx
my_file_1.pyx:54:5: 'get_conversion_factor' imported but unused
my_file_2.pyx:1112:38: 'mod' defined but unused (try prefixing with underscore?)
my_file_3.pyx:4:9: dangerous default value!
my_file_3.pyx:5:9: comma after base type in definition

Configuration

The following configuration options are available:

  • exclude lines by including a # no-cython-lint comment (analogous to # noqa in flake8);

as well as the following command-line arguments:

  • --max-line-length to control the maximum line length used by pycodestyle;
  • --no-pycodestyle if you don't want the pycodestyle checks;
  • --ignore if you want to ignore some specific pycodestyle checks;
  • --files to pass a Regex pattern with which to match files to include;
  • --exclude to pass a Regex pattern with which to match files to exclude.

Configuration can be set project-wise in a pyproject.toml file at the root of the project. Here's an example pyproject.toml:

[tool.cython-lint]
max-line-length = 88
ignore = ['E503', 'E504']
exclude = 'my_project/excluded_cython_file.pyx'

Which checks are implemented?

  • assert statement with tuple condition (always true...)
  • comma after base type definition (e.g. cdef ndarray, arr)
  • comparison between constants
  • dangerous default value
  • dict key repeated
  • dict key variable repeated
  • f-string without placeholders
  • if-statement with tuple condition (always true...)
  • late-binding closures https://docs.python-guide.org/writing/gotchas/#late-binding-closures
  • pointless string statement
  • pycodestyle nitpicks (which you can turn off with --no-pycodestyle)
  • repeated element in set
  • .strip, .rstrip, or .lstrip used with repeated characters
  • unnecessary list index lookup
  • unnecessary import alias
  • variable defined but unused
  • variable imported but unused

In addition, the following automated fixers are implemented:

  • double-quote-cython-strings (replace single quotes with double quotes, like the black formatter does)

More to come! Requests welcome!

Project details


Download files

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

Source Distribution

cython_lint-0.16.2.tar.gz (26.4 kB view details)

Uploaded Source

Built Distribution

cython_lint-0.16.2-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file cython_lint-0.16.2.tar.gz.

File metadata

  • Download URL: cython_lint-0.16.2.tar.gz
  • Upload date:
  • Size: 26.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cython_lint-0.16.2.tar.gz
Algorithm Hash digest
SHA256 61a0dd24009af14e86df67bf38dd4e4aeeb511ceaaf6af0dbd4dcccffd76149e
MD5 27f18b4905a77573456ccf9ad54ddb94
BLAKE2b-256 34e2cc4f951fa556c6d8d913bca4b0ef42a90eaeeacc9bc26d37abd05f0af127

See more details on using hashes here.

Provenance

File details

Details for the file cython_lint-0.16.2-py3-none-any.whl.

File metadata

  • Download URL: cython_lint-0.16.2-py3-none-any.whl
  • Upload date:
  • Size: 12.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cython_lint-0.16.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1019409277f84296d8ac69efe159429799f8e6a538c3f7071e27f492ac27a8a7
MD5 c6b29e827d8038db2d383110a8339cc9
BLAKE2b-256 88876bc789cabb5e594257d8a148861f5741bc2509846dee5080fd86cc960a56

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page