Skip to content

Latest commit

 

History

History
51 lines (40 loc) · 2.3 KB

README.md

File metadata and controls

51 lines (40 loc) · 2.3 KB

casaconfig

Runtime data necessary for CASA operation.

Release Instructions

  1. Create a release branch with a version name (ie v1.6.2)
  2. Ensure the version number in pyproject.toml on the branch is set correctly
  3. Create a tag of the release branch (ie v1.6.2-1)
  4. Github Action runs automatically to publish a pip package to pypi

Installation

$: pip install casaconfig

Usage

See the casaconfig API documentation on casadocs (links above).

Also see the External Data section of casadocs for additional details

Developers Instructions

  1. every push to the casaconfig repository will push a new wheel to test pypi
  2. the version in pyproject.toml must be updated before each push so that the wheel has a unique name (e.g. "1.2.3dev2", where "dev?" could be incremented during development; see the specification for more information about valid version signifiers)
  3. When testing with a casatools build, "pip install" the development casaconfig wheel before running any tests - it may be installed before casatools is installed or after since the casatools build does not depend on casasconfig (uninstall any already installed casaconfig if necessary).
  4. For release, follow the above instructions.

Wheels can be built locally following the same process used by the CI actions. To install the build-system dependencies as defined in pyproject.toml and then generate a source distribution and wheel:

python3 -m pip install build setuptools --user
python3 -m build

This will create:

casaconfig.egg-info
├── PKG-INFO
├── SOURCES.txt
├── dependency_links.txt
├── requires.txt
└── top_level.txt
dist
├── casaconfig-[VERSION]-py3-none-any.whl
└── casaconfig-[VERSION].tar.gz