util functions for software life cycle enforcement on github

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for alexdunnjpl from gravatar.com alexdunnjpl Avatar for collinss-jpl from gravatar.com collinss-jpl Avatar for jdyoung from gravatar.com jdyoung Avatar for jpadams from gravatar.com jpadams Avatar for nutjob from gravatar.com nutjob Avatar for pdsen-ci from gravatar.com pdsen-ci Avatar for tloubrieu from gravatar.com tloubrieu Avatar for viviant from gravatar.com viviant

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (apache-2.0)
  • Author: thomas loubrieu
  • Tags github, action, github action, snapshot, release, maven
  • Requires: Python >=3.6
Classifiers
Report project as malware

Project description

PDS utility function for github

Enforces the PDS engineering node software lifecycle:

  • publish snapshot releases for python (python-snapshot-release) or maven (maven-snaphot-release) projects
  • create requirements reports (requirement-report)
  • ping a repository, ie creates an empty commit & push e.g. to trigger github action (git-ping)
  • create build summaries from .gitmodule file (summaries)

These routines are called from github actions.

They are orchestrated around the pdsen-corral repository

Prerequisites

libxml2 is used to do publish a snapshot release of a maven project (maven-snaphot-release). It needs to be deployed as follow:

Macos

brew install libxml2
cd ./venv/lib/python3.7/site-packages/  # chose the site package of the used python
ln -s /usr/local/Cellar/libxml2/2.9.10/lib/python3.7/site-packages/* .

Ubuntu

sudo apt-get update && sudo apt-get install libxml2-dev libxslt-dev python-dev
pip install lxml

deploy and run

Deploy:

pip install pds-gihub-util

Some environment variable need to be set (they are defined by default in github action but need to be set manually otherwise)

export GITHUB_WORKSPACE=<where the repository which we want to publish a snapshot is cloned>
export GITHUB_REPOSITORY=<full name of the repository which we want to publish for example NASA-PDS-Incubator/pds-app-registry>

Get command arguments:

maven-snapshot-release --help
python-snapshot-release --help
requirement-report --help
git-ping --help
summaries --help

Development

git clone ...
cd pds-github-util
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Update the code

Test the code:

export GITHUB_TOKEN=<personal access token for github>
python setup.py test

Create package and publish it:

Set the version in setup.py

Tag the code

git tag <version>
git push origin --tags

The package will be published to pypi automatically though github action.

Manually publish the package

Create the package:

python setup.py sdist

Publish it as a github release.

Publish on pypi (you need a pypi account):

pip install twine
twine upload dist/*

Supported by

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