Skip to main content

A Flake8 plugin to check docstrings for double backticked strings which should be links to the Python documentation.

Docs

Documentation Build Status Docs Check Status

Tests

Linux Test Status Windows Test Status macOS Test Status Coverage

PyPI

PyPI - Package Version PyPI - Supported Python Versions PyPI - Supported Implementations PyPI - Wheel

Anaconda

Conda - Package Version Conda - Platform

Activity

GitHub last commit GitHub commits since tagged version Maintenance PyPI - Downloads

QA

CodeFactor Grade Flake8 Status mypy status

Other

License GitHub top language Requirements Status

For example, ``True`` should be py:obj:`True`, which Sphinx will render as a link to the Python documentation.

reStructuredText .rst files are not currently checked.

Installation

flake8_sphinx_links can be installed from PyPI or Anaconda.

To install with pip:

$ python -m pip install flake8_sphinx_links

To install with conda:

  • First add the required channels

$ conda config --add channels https://conda.anaconda.org/conda-forge
$ conda config --add channels https://conda.anaconda.org/domdfcoding
  • Then install

$ conda install flake8_sphinx_links

Flake8 codes

Code

Description

SXL001

Double backticked variable should be a link to Python documentation.

Use as a pre-commit hook

See pre-commit for instructions

Sample .pre-commit-config.yaml:

- repo: https://gitlab.com/pycqa/flake8
  rev: 3.8.1
  hooks:
   - id: flake8
     additional_dependencies: [flake8-sphinx-links==0.2.2]

Release files for flake8-sphinx-links 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flake8-sphinx-links 0.2.2
File Size Uploaded
flake8_sphinx_links-0.2.2.tar.gz 6.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for flake8-sphinx-links 0.2.2
File Interpreter ABI Platform
flake8_sphinx_links-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 24.2 kB

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.4

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page