Metadata-Version: 2.1
Name: antsibull
Version: 0.20.0
Summary: Tools for building the Ansible Distribution
Home-page: https://github.com/ansible-community/antsibull
License: GPL-3.0-or-later
Author: Toshio Kuratomi
Author-email: a.badger@gmail.com
Requires-Python: >=3.6.0,<4.0.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Dist: PyYAML
Requires-Dist: aiocontextvars; python_version >= "3.6" and python_version < "3.7"
Requires-Dist: aiofiles
Requires-Dist: aiohttp
Requires-Dist: antsibull-changelog (>=0.7.0)
Requires-Dist: asyncio-pool
Requires-Dist: docutils
Requires-Dist: jinja2
Requires-Dist: packaging (>=20.0)
Requires-Dist: perky
Requires-Dist: pydantic
Requires-Dist: rstcheck (>=3,<4)
Requires-Dist: semantic_version
Requires-Dist: sh
Requires-Dist: twiggy (>=0.5.0)
Project-URL: Repository, https://github.com/ansible-community/antsibull
Description-Content-Type: text/markdown

# antsibull -- Ansible Build Scripts
Tooling for building various things related to Ansible

Scripts that are here:

* antsibull-build - Builds Ansible-2.10+ from component collections ([docs](docs/build-ansible.rst))
* antsibull-docs - Extracts documentation from ansible plugins
* antsibull-lint - Right now only validates ``changelogs/changelog.yaml`` files ([docs](docs/changelog.yaml-format.md))

A related project is [antsibull-changelog](https://pypi.org/project/antsibull-changelog/), which is in its [own repository](https://github.com/ansible-community/antsibull-changelog/).

Scripts are created by poetry at build time.  So if you want to run from
a checkout, you'll have to run them under poetry::

    python3 -m pip install poetry
    poetry install  # Installs dependencies into a virtualenv
    poetry run antsibull-build --help

If you want to create a new release::

    poetry build
    poetry publish  # Uploads to pypi.  Be sure you really want to do this

.. note:: When installing a package published by poetry, it is best to use
    pip >= 19.0.  Installing with pip-18.1 and below could create scripts which
    use pkg_resources which can slow down startup time (in some environments by
    quite a large amount).

Unless otherwise noted in the code, it is licensed under the terms of the GNU
General Public License v3 or, at your option, later.

