Metadata-Version: 2.1
Name: pyaud-plugins
Version: 0.14.0
Summary: Plugin package for Pyaud
Home-page: https://pypi.org/project/pyaud-plugins/
License: MIT
Keywords: audit,ci,plugins,pyaud,python
Author: jshwi
Author-email: stephen@jshwisolutions.com
Maintainer: jshwi
Maintainer-email: stephen@jshwisolutions.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: Sphinx (>=4.3.2,<7.0.0)
Requires-Dist: appdirs (>=1.4.4,<2.0.0)
Requires-Dist: black (>=21.12,<24.0)
Requires-Dist: codecov (>=2.1.12,<3.0.0)
Requires-Dist: constcheck (>=0,<1)
Requires-Dist: coverage (>=6.2,<8.0)
Requires-Dist: docformatter (>=1.4,<2.0)
Requires-Dist: docsig (>=0.34.0)
Requires-Dist: environs (>=9.4.0,<10.0.0)
Requires-Dist: flynt (>=0.75,<0.77)
Requires-Dist: gitpython (>=3.1.30,<4.0.0)
Requires-Dist: isort (>=5.10.1,<6.0.0)
Requires-Dist: mypy (>=0.930,<1.1)
Requires-Dist: object-colors (>=2.0.1,<3.0.0)
Requires-Dist: pipfile-requirements (>=0.3.0,<0.4.0)
Requires-Dist: pyaud (>=5.0.1,<7.0.0)
Requires-Dist: pylint (>=2.12.2,<3.0.0)
Requires-Dist: pytest (>=7.2.0,<8.0.0)
Requires-Dist: pytest-cov (>=3,<5)
Requires-Dist: python-dotenv (>=0.19.2,<1.1.0)
Requires-Dist: pyyaml (>=6.0,<7.0)
Requires-Dist: readmetester (>=1.0.1,<3.0.0)
Requires-Dist: setuptools (>=67.2.0,<68.0.0)
Requires-Dist: sphinx-markdown-builder (>=0.5.5,<0.6.0)
Requires-Dist: sphinxcontrib-fulltoc (>=1.2.0,<2.0.0)
Requires-Dist: sphinxcontrib-programoutput (>=0.17,<0.18)
Requires-Dist: toml (>=0.10.2,<0.11.0)
Requires-Dist: toml-sort (>=0.20,<0.23)
Requires-Dist: tomli (>=2.0.1,<3.0.0)
Requires-Dist: vulture (>=2.3,<3.0)
Project-URL: Documentation, https://pyaud-plugins.readthedocs.io/en/latest
Project-URL: Repository, https://github.com/jshwi/pyaud-plugins
Description-Content-Type: text/x-rst

pyaud-plugins
=============
.. 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/pyaud-plugins
    :target: https://pypi.org/project/pyaud-plugins/
    :alt: PyPI
.. image:: https://github.com/jshwi/pyaud-plugins/actions/workflows/ci.yml/badge.svg
    :target: https://github.com/jshwi/pyaud-plugins/actions/workflows/ci.yml
    :alt: CI
.. image:: https://results.pre-commit.ci/badge/github/jshwi/pyaud-plugins/master.svg
   :target: https://results.pre-commit.ci/latest/github/jshwi/pyaud-plugins/master
   :alt: pre-commit.ci status
.. image:: https://github.com/jshwi/pyaud-plugins/actions/workflows/codeql-analysis.yml/badge.svg
    :target: https://github.com/jshwi/pyaud-plugins/actions/workflows/codeql-analysis.yml
    :alt: CodeQL
.. image:: https://codecov.io/gh/jshwi/pyaud-plugins/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/jshwi/pyaud-plugins
    :alt: codecov.io
.. image:: https://readthedocs.org/projects/pyaud-plugins/badge/?version=latest
    :target: https://pyaud-plugins.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
.. image:: https://snyk.io/test/github/jshwi/pyaud-plugins/badge.svg
    :target: https://snyk.io/test/github/jshwi/pyaud-plugins/badge.svg
    :alt: Known Vulnerabilities

Plugin package for Pyaud
------------------------

Dependencies
------------

``pip install pyaud``

Install
-------

``pip install pyaud-plugins``

Development
-----------

``poetry install``

Usage
-----

See `pyaud <https://github.com/jshwi/pyaud#pyaud>`_

Plugins
-------

``pyaud`` will automatically load this package on search for all packages prefixed with `"pyaud_"`

For writing plugins see `docs <https://jshwi.github.io/pyaud/pyaud.html#pyaud-plugins>`_

This package contains the following plugins on running `pyaud modules`

.. code-block:: console

    about-tests     -- Check tests README is up-to-date
    audit           -- Read from [audit] key in config
    change-logged   -- Check commits with loggable tags are added to CHANGELOG
    clean           -- Remove all unversioned package files recursively
    commit-policy   -- Test commit policy is up to date
    const           -- Check code for repeat use of strings
    coverage        -- Run package unit-tests with `pytest` and `coverage`
    docs            -- Compile package documentation with `Sphinx`
    doctest         -- Run `doctest` on all code examples
    doctest-package -- Run `doctest` on package
    doctest-readme  -- Run `doctest` on Python code-blocks in README
    files           -- Audit project data files
    format          -- Audit code with `Black`
    format-docs     -- Format docstrings with `docformatter`
    format-str      -- Format f-strings with `flynt`
    generate-rcfile -- Print rcfile to stdout
    imports         -- Audit imports with `isort`
    lint            -- Lint code with `pylint`
    params          -- Check docstring params match function signatures
    sort-pyproject  -- Sort pyproject.toml file with `toml-sort`
    test            -- Run all tests
    tests           -- Run the package unit-tests with `pytest`
    toc             -- Audit docs/<NAME>.rst toc-file
    typecheck       -- Typecheck code with `mypy`
    unused          -- Audit unused code with `vulture`
    whitelist       -- Check whitelist.py file with `vulture`

