readmetester


Namereadmetester JSON
Version 2.4.1 PyPI version JSON
download
home_pagehttps://pypi.org/project/readmetester/
SummaryParse, test, and assert RST code-blocks
upload_time2023-01-07 01:43:54
maintainerjshwi
docs_urlNone
authorjshwi
requires_python>=3.8,<4.0
licenseMIT
keywords assert code readme rst test
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            readmetester
============
.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
    :target: https://opensource.org/licenses/MIT
    :alt: License
.. image:: https://img.shields.io/pypi/v/readmetester
    :target: https://pypi.org/project/readmetester/
    :alt: PyPI
.. image:: https://github.com/jshwi/readmetester/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/jshwi/readmetester/actions/workflows/ci.yml
    :alt: CI
.. image:: https://results.pre-commit.ci/badge/github/jshwi/readmetester/master.svg
   :target: https://results.pre-commit.ci/latest/github/jshwi/readmetester/master
   :alt: pre-commit.ci status
.. image:: https://github.com/jshwi/readmetester/actions/workflows/codeql-analysis.yml/badge.svg
    :target: https://github.com/jshwi/readmetester/actions/workflows/codeql-analysis.yml
    :alt: CodeQL
.. image:: https://codecov.io/gh/jshwi/readmetester/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/jshwi/readmetester
    :alt: codecov.io
.. image:: https://readthedocs.org/projects/readmetester/badge/?version=latest
    :target: https://readmetester.readthedocs.io/en/latest/?badge=latest
    :alt: readthedocs.org
.. image:: https://img.shields.io/badge/python-3.8-blue.svg
    :target: https://www.python.org/downloads/release/python-380
    :alt: python3.8
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black
    :alt: Black
.. image:: https://img.shields.io/badge/linting-pylint-yellowgreen
    :target: https://github.com/PyCQA/pylint
    :alt: pylint

Parse, test, and assert RST code-blocks
---------------------------------------

**Installation**

.. code-block:: console

    $ pip install readmetester
..

**Usage**

``readmetester [-h] [--version] [README.rst]``

If a README.rst file is present in the current working directory it will be used if no arguments are provided

.. code-block:: console

    $ readmetester README.rst
..

**Documenting**

Python code begins with ``">>> "``

Continuation lines begin with ``"... "``

.. note::

    The length of these strings is 4 including the whitespace at the end
..

Expected output can be quoted or unquoted

.. code-block:: RST

    .. code-block:: python

        >>> n = [
        ...     "zero",
        ...     "one",
        ...     "two",
        ... ]
        >>> for c, i in enumerate(n):
        ...     print(c, i)
        0 zero
        1 one
        2 two


Styles can be configured in a pyproject.toml file

.. code-block:: toml

    [tool.readmetester]
    style = "monokai"

            

Raw data

            {
    "_id": null,
    "home_page": "https://pypi.org/project/readmetester/",
    "name": "readmetester",
    "maintainer": "jshwi",
    "docs_url": null,
    "requires_python": ">=3.8,<4.0",
    "maintainer_email": "stephen@jshwisolutions.com",
    "keywords": "assert,code,readme,rst,test",
    "author": "jshwi",
    "author_email": "stephen@jshwisolutions.com",
    "download_url": "https://files.pythonhosted.org/packages/ce/85/d2af71d065865050dea275908996cb6edd54b6fb2cdc82b4ca32aa3f2565/readmetester-2.4.1.tar.gz",
    "platform": null,
    "description": "readmetester\n============\n.. image:: https://img.shields.io/badge/License-MIT-yellow.svg\n    :target: https://opensource.org/licenses/MIT\n    :alt: License\n.. image:: https://img.shields.io/pypi/v/readmetester\n    :target: https://pypi.org/project/readmetester/\n    :alt: PyPI\n.. image:: https://github.com/jshwi/readmetester/actions/workflows/ci.yml/badge.svg\n    :target: https://github.com/jshwi/readmetester/actions/workflows/ci.yml\n    :alt: CI\n.. image:: https://results.pre-commit.ci/badge/github/jshwi/readmetester/master.svg\n   :target: https://results.pre-commit.ci/latest/github/jshwi/readmetester/master\n   :alt: pre-commit.ci status\n.. image:: https://github.com/jshwi/readmetester/actions/workflows/codeql-analysis.yml/badge.svg\n    :target: https://github.com/jshwi/readmetester/actions/workflows/codeql-analysis.yml\n    :alt: CodeQL\n.. image:: https://codecov.io/gh/jshwi/readmetester/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/jshwi/readmetester\n    :alt: codecov.io\n.. image:: https://readthedocs.org/projects/readmetester/badge/?version=latest\n    :target: https://readmetester.readthedocs.io/en/latest/?badge=latest\n    :alt: readthedocs.org\n.. image:: https://img.shields.io/badge/python-3.8-blue.svg\n    :target: https://www.python.org/downloads/release/python-380\n    :alt: python3.8\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n    :alt: Black\n.. image:: https://img.shields.io/badge/linting-pylint-yellowgreen\n    :target: https://github.com/PyCQA/pylint\n    :alt: pylint\n\nParse, test, and assert RST code-blocks\n---------------------------------------\n\n**Installation**\n\n.. code-block:: console\n\n    $ pip install readmetester\n..\n\n**Usage**\n\n``readmetester [-h] [--version] [README.rst]``\n\nIf a README.rst file is present in the current working directory it will be used if no arguments are provided\n\n.. code-block:: console\n\n    $ readmetester README.rst\n..\n\n**Documenting**\n\nPython code begins with ``\">>> \"``\n\nContinuation lines begin with ``\"... \"``\n\n.. note::\n\n    The length of these strings is 4 including the whitespace at the end\n..\n\nExpected output can be quoted or unquoted\n\n.. code-block:: RST\n\n    .. code-block:: python\n\n        >>> n = [\n        ...     \"zero\",\n        ...     \"one\",\n        ...     \"two\",\n        ... ]\n        >>> for c, i in enumerate(n):\n        ...     print(c, i)\n        0 zero\n        1 one\n        2 two\n\n\nStyles can be configured in a pyproject.toml file\n\n.. code-block:: toml\n\n    [tool.readmetester]\n    style = \"monokai\"\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Parse, test, and assert RST code-blocks",
    "version": "2.4.1",
    "split_keywords": [
        "assert",
        "code",
        "readme",
        "rst",
        "test"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9e15720ead3c3ddff62eb79b466adeaf7014ccee5bf4c0001f2dac2ff33f2021",
                "md5": "bea7e1e2352f7de26a54b7b73abca884",
                "sha256": "f471b3180056171dd496e70ef64a63194b341c5eb33ee85c2d9121b885b80ea1"
            },
            "downloads": -1,
            "filename": "readmetester-2.4.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bea7e1e2352f7de26a54b7b73abca884",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<4.0",
            "size": 11646,
            "upload_time": "2023-01-07T01:43:52",
            "upload_time_iso_8601": "2023-01-07T01:43:52.665950Z",
            "url": "https://files.pythonhosted.org/packages/9e/15/720ead3c3ddff62eb79b466adeaf7014ccee5bf4c0001f2dac2ff33f2021/readmetester-2.4.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ce85d2af71d065865050dea275908996cb6edd54b6fb2cdc82b4ca32aa3f2565",
                "md5": "900861aeac7ea2ec86cae52eb58195f8",
                "sha256": "10851e41908a4e1a28c2d1f09a74f8bc2e079529c506d5a5683bb9a189449382"
            },
            "downloads": -1,
            "filename": "readmetester-2.4.1.tar.gz",
            "has_sig": false,
            "md5_digest": "900861aeac7ea2ec86cae52eb58195f8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<4.0",
            "size": 11344,
            "upload_time": "2023-01-07T01:43:54",
            "upload_time_iso_8601": "2023-01-07T01:43:54.252830Z",
            "url": "https://files.pythonhosted.org/packages/ce/85/d2af71d065865050dea275908996cb6edd54b6fb2cdc82b4ca32aa3f2565/readmetester-2.4.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-01-07 01:43:54",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "readmetester"
}
        
Elapsed time: 0.03692s