Skip to main content

A linter for Cython files

Project description

Build Status Coverage pre-commit.ci status

cython-lint

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

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.2.0
    hooks:
    -   id: cython-lint

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

Configuration

The following configuration options are available:

  • exclude lines by including a # no-cython-lint comment (analogous to # noqa in flake8);
  • use the command-line argument --max-line-length to control the maximum line length used by pycodestyle;
  • use the command-line argument --no-pycodestyle if you don't want the pycodestyle checks.

Currently, the following checks are implemented:

  • variable defined but unused
  • variable imported but unused
  • pycodestyle checks, except these that aren't in general applicable to Cython code:
    • E121 continuation line under-indented for hanging indent
    • E123 closing bracket does not match indentation of opening bracket’s line
    • E126 continuation line over-indented for hanging indent
    • E133 closing bracket is missing indentation
    • E203 whitespace before ‘,’, ‘;’, or ‘:’
    • E211 whitespace before '('
    • E225 missing whitespace around operator
    • E226 missing whitespace around arithmetic operator
    • E227 missing whitespace around bitwise or shift operator
    • E241 multiple spaces after ‘,’
    • E242 tab after ‘,’
    • E271 multiple spaces after keyword
    • E272 multiple spaces before keyword
    • E275 missing whitespace after keyword
    • E4 imports (isort supports Cython code, best to just use that)
    • E704 multiple statements on one line (def)
    • E9 runtime
    • W5 line break warning

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.2.0.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

cython_lint-0.2.0-py2.py3-none-any.whl (7.0 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: cython_lint-0.2.0.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.8.15

File hashes

Hashes for cython_lint-0.2.0.tar.gz
Algorithm Hash digest
SHA256 50e47be1db932b8a1d65a45998f5bc5aeaa1da724b56b334d0606785d818b030
MD5 0c5bb7911d99819366bd8465976f2438
BLAKE2b-256 2bd917001dd7021071f72db5b90d505a354d7d26dca9ca97d1ebb5284d38e742

See more details on using hashes here.

Provenance

File details

Details for the file cython_lint-0.2.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for cython_lint-0.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 417ca0514655217e8a43c55bbf6f06785908c97fdcdf2ef438cf8152ed8df475
MD5 4f5dbfd393f0d101a002968f2065d44c
BLAKE2b-256 8fc2488a8ae9ceb0a9eaf9f667e640c7dc9476029438b7a59be04e86068a9b34

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