docs: add mention of store plugin (#146)

* docs: add mention of store plugin

Signed-off-by: Henry Schreiner <[email protected]>

* Apply suggestions from code review

Co-authored-by: Henry Schreiner <[email protected]>

---------

Signed-off-by: Henry Schreiner <[email protected]>
Co-authored-by: Anderson Bravalheri <[email protected]>

README.rst

@@ -136,6 +136,22 @@ extending the validation with your own plugins_.
    If you consider contributing to this project, have a look on our
    `contribution guides`_.
 
+Plugins
+=======
+
+The `validate-pyproject-schema-store`_ plugin has a vendored copy of
+pyproject.toml related `SchemaStore`_ entries.  You can even install this using
+the ``[store]`` extra:
+
+    $ pipx install 'validate-pyproject[all,store]'
+
+Some of the tools in SchemaStore also have integrated validate-pyproject
+plugins, like ``cibuildwheel`` and ``scikit-build-core``. However, unless you
+want to pin an exact version of those tools, the SchemaStore copy is lighter
+weight than installing the entire package.
+
+If you want to write a custom plugin for your tool, please consider also contributing a copy to SchemaStore.
+
 pre-commit
 ==========
 
@@ -146,9 +162,11 @@ pre-commit
     ---
     repos:
       - repo: https://github.com/abravalheri/validate-pyproject
-        rev: main
+        rev: <insert current version here>
         hooks:
           - id: validate-pyproject
+          # Optional extra validations from SchemaStore:
+          additional_dependencies: ["validate-pyproject-schema-store[all]"]
 
 By default, this ``pre-commit`` hook will only validate the ``pyproject.toml``
 file at the root of the project repository.
@@ -158,6 +176,8 @@ the ``files`` parameter.
 You can also use ``pre-commit autoupdate`` to update to the latest stable
 version of ``validate-pyproject`` (recommended).
 
+You can also use `validate-pyproject-schema-store`_ as a pre-commit hook, which
+allows pre-commit to pin and update that instead of ``validate-pyproject`` itself.
 
 Note
 ====
@@ -188,3 +208,5 @@ For details and usage information on PyScaffold see https://pyscaffold.org/.
 .. _pre-compiled way: https://validate-pyproject.readthedocs.io/en/latest/embedding.html
 .. _plugins: https://validate-pyproject.readthedocs.io/en/latest/dev-guide.html
 .. _virtual environment: https://realpython.com/python-virtual-environments-a-primer/
+.. _validate-pyproject-schema-store: https://github.com/henryiii/validate-pyproject-schema-store
+.. _SchemaStore: https://www.schemastore.org

setup.cfg

@@ -32,7 +32,11 @@ platforms = any
 # https://pypi.org/classifiers/
 classifiers =
     Development Status :: 4 - Beta
+    Intended Audience :: Developers
+    Operating System :: OS Independent
     Programming Language :: Python
+    Topic :: Software Development :: Quality Assurance
+    Typing :: Typed
 
 
 [options]
@@ -66,6 +70,9 @@ all =
     packaging>=20.4
     trove-classifiers>=2021.10.20
 
+store =
+    validate-pyproject-schema-store
+
 # Add here test requirements (semicolon/line-separated)
 testing =
     setuptools