Skip to main content

Internal utilities for projects following git-pull python package spec

Project description

gp-libs · Python Package License Code Coverage

Incubating / dogfooding some sphinx extensions and pytest plugins on git-pull projects, e.g. cihai, vcs-python, or tmux-python.

doctest helpers (for docutils)

Two parts:

  1. doctest module: Same specification as doctest, but can parse reStructuredText and markdown
  2. pytest plugin: Collects pytest for reStructuredText and markdown files

doctest module

This extends standard library doctest to support anything docutils can parse. It can parse reStructuredText (.rst) and markdown (.md).

It supports two barebones directives:

  • docutils' doctest_block

    >>> 2 + 2
    4
    
  • .. doctest:: directive

    reStructuredText:

    .. doctest::
    
       >>> 2 + 2
       4
    

    Markdown (requires myst-parser):

    ```{doctest}
    >>> 2 + 2
    4
    ```
    

pytest plugin

...

This plugin integrates with the above module.

$ pytest docs/

Like the above module, it supports docutils' own doctest_block and a basic .. doctest:: directive.

sphinx plugins

Plain-text issue linker (linkify-issues)

We need to parse plain text, e.g. #99999, to point to the project tracker at https://github.com/git-pull/gp-libs/issues/99999. This way the markdown looks good anywhere you render it, including GitHub and GitLab.

Table of contents for autodoc

sphinx.ext.autodoc doesn't link objects in the table of contents. So we need a plugin to help.

Install

$ pip install --user gp-libs

Developmental releases

You can test the unpublished version of g before its released.

  • pip:

    $ pip install --user --upgrade --pre gp-libs
    

More information

Docs Build Status

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

gp-libs-0.0.1a2.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

gp_libs-0.0.1a2-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file gp-libs-0.0.1a2.tar.gz.

File metadata

  • Download URL: gp-libs-0.0.1a2.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for gp-libs-0.0.1a2.tar.gz
Algorithm Hash digest
SHA256 1238990e6cb08ecc6bed9ddf7b804f2d6e40d5a79823b33fd50a0107234c075a
MD5 6bb3649874be3dd31b75a5305b2922b0
BLAKE2b-256 b7f6381cb41d2100e3c59fb88686038ff6ea295a3f3aa8d27321baca5362145e

See more details on using hashes here.

File details

Details for the file gp_libs-0.0.1a2-py3-none-any.whl.

File metadata

  • Download URL: gp_libs-0.0.1a2-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for gp_libs-0.0.1a2-py3-none-any.whl
Algorithm Hash digest
SHA256 34a4e3ef9b89f5d4bb65140953d7a1272d42bc11abed954e72ec29375db4c27c
MD5 6ea8c188ed7a21c73c687d7e28a16891
BLAKE2b-256 f14cdf1be3100c0f58d7b8cd3f99a7d7adf305b00fda2fb401019af9a23bfd5c

See more details on using hashes here.

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