Skip to main content

Utilities for building and installing Astropy, Astropy affiliated packages, and their respective documentation.

Project description

This project provides a Python package, astropy_helpers, which includes many build, installation, and documentation-related tools used by the Astropy project, but packaged separately for use by other projects that wish to leverage this work. The motivation behind this package and details of its implementation are in the accepted Astropy Proposal for Enhancement (APE) 4.

The astropy_helpers.extern sub-module includes modules developed elsewhere that are bundled here for convenience. At the moment, this consists of the following two sphinx extensions:

  • numpydoc, a Sphinx extension developed as part of the Numpy project. This is used to parse docstrings in Numpy format

  • sphinx-automodapi, a Sphinx developed as part of the Astropy project. This used to be developed directly in astropy-helpers but is now a standalone package.

Issues with these sub-modules should be reported in their respective repositories, and we will regularly update the bundled versions to reflect the latest released versions.

astropy_helpers includes a special “bootstrap” module called ah_bootstrap.py which is intended to be used by a project’s setup.py in order to ensure that the astropy_helpers package is available for build/installation. This is similar to the ez_setup.py module that is shipped with some projects to bootstrap setuptools.

As described in APE4, the version numbers for astropy_helpers follow the corresponding major/minor version of the astropy core package, but with an independent sequence of micro (bugfix) version numbers. Hence, the initial release is 0.4, in parallel with Astropy v0.4, which will be the first version of Astropy to use astropy-helpers.

For examples of how to implement astropy-helpers in a project, see the setup.py and setup.cfg files of the Affiliated package template.

https://travis-ci.org/astropy/astropy-helpers.svg https://coveralls.io/repos/astropy/astropy-helpers/badge.svg

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

astropy-helpers-2.0.1.tar.gz (122.1 kB view details)

Uploaded Source

File details

Details for the file astropy-helpers-2.0.1.tar.gz.

File metadata

File hashes

Hashes for astropy-helpers-2.0.1.tar.gz
Algorithm Hash digest
SHA256 42427a1b3f027b2bfeb528610bc3d82d182053323b51a97403a4ce09fa3bbc82
MD5 f94eca84eaae23c96d1a3c8b37a910f2
BLAKE2b-256 4e86becb9e102fdfffb3bf2f3d96206d5f20fcb4f0d78d05bf5d9d80db2f766a

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page