Metadata-Version: 2.1
Name: jaraco.packaging
Version: 10.1.0
Summary: tools to supplement packaging Python releases
Home-page: https://github.com/jaraco/jaraco.packaging
Author: Jason R. Coombs
Author-email: jaraco@jaraco.com
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Framework :: Sphinx :: Extension
Requires-Python: >=3.8
License-File: LICENSE
Requires-Dist: build[virtualenv]
Requires-Dist: jaraco.context
Requires-Dist: sphinx
Requires-Dist: domdf-python-tools
Provides-Extra: docs
Requires-Dist: sphinx>=3.5; extra == "docs"
Requires-Dist: jaraco.packaging>=9.3; extra == "docs"
Requires-Dist: rst.linker>=1.9; extra == "docs"
Requires-Dist: furo; extra == "docs"
Requires-Dist: sphinx-lint; extra == "docs"
Provides-Extra: testing
Requires-Dist: pytest!=8.1.1,>=6; extra == "testing"
Requires-Dist: pytest-checkdocs>=2.4; extra == "testing"
Requires-Dist: pytest-cov; extra == "testing"
Requires-Dist: pytest-mypy; extra == "testing"
Requires-Dist: pytest-enabler>=2.2; extra == "testing"
Requires-Dist: pytest-ruff>=0.2.1; extra == "testing"
Requires-Dist: types-docutils; extra == "testing"

.. image:: https://img.shields.io/pypi/v/jaraco.packaging.svg
   :target: https://pypi.org/project/jaraco.packaging

.. image:: https://img.shields.io/pypi/pyversions/jaraco.packaging.svg

.. image:: https://github.com/jaraco/jaraco.packaging/actions/workflows/main.yml/badge.svg
   :target: https://github.com/jaraco/jaraco.packaging/actions?query=workflow%3A%22tests%22
   :alt: tests

.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json
    :target: https://github.com/astral-sh/ruff
    :alt: Ruff

.. image:: https://readthedocs.org/projects/jaracopackaging/badge/?version=latest
   :target: https://jaracopackaging.readthedocs.io/en/latest/?badge=latest

.. image:: https://img.shields.io/badge/skeleton-2024-informational
   :target: https://blog.jaraco.com/skeleton

Tools for packaging.


sphinx
======

This package provides a Sphinx extension that will inject into the config
the following values from the project's package metadata (as presented by
distutils):

 - project (from name)
 - author
 - copyright (same as author)
 - version
 - release (same as version)
 - package_url (from url)

To enable, include 'jaraco.packaging' in the requirements and add
'jaraco.packaging.sphinx' to the list of extensions in a Sphinx config
file::

    extensions=['jaraco.packaging.sphinx']

The extension by default builds the project in an isolated environment in
order to extract the metadata. For offline builds, set
``BUILD_ENVIRONMENT=current`` and ensure the build dependencies are
met in the current environment.

Deprecated: To build the documentation offline,
provide an already built wheel by setting the environment variable
``JARACO_PACKAGING_SPHINX_WHEEL`` to the path of an existing wheel.


make-tree
=========

A utility for taking output from ``pipdeptree --json`` and producing a tree
rooted at a given package.

Usage::

    pipdeptree --json | python -m jaraco.packaging.make-tree mypkg


metadata
=========

A wrapper around ``build.util.project_wheel_metadata`` to enable dowstream
packagers to indicate that they need an isolated build. Set the environment
variable ``BUILD_ENVIRONMENT=current`` to bypass build isolation and use the
current isolation for loading metadata from a project.
