ocpiupdate 0.6.0

An updater for OpenCPI Projects

ocpiupdate - An updater for OpenCPI projects

ocpiupdate updates OpenCPI Projects to use style associated with newer versions of OpenCPI.

For example:

• Using <worker>-<model>.xml for the Worker Description files, instead of <worker>.xml.
• Using <component>.comp/<component>-comp.xml for Component Specification files instead of specs/<component>[-_]spec.xml.
• Using xml files instead of Makefiles.

Dependencies

This library requires Python 3.12 or newer. This means it doesn't support the default system python3 install on Ubuntu 20.04 or Ubuntu 22.04.

If you use a system with Python 3.11 or older, you need to either:

• Install a newer python3 just for this library.
  • I'd recommend using a tool like uv.
• Download and run the containerised version.

Installation

pip

You can install the latest release from PyPi:

pip install ocpiupdate

Or, you can install this repository directly:

# Installs `develop` branch
pip install git+https://gitlab.com/dawalters/ocpiupdate

# Installs `v0.6.0` tag
pip install git+https://gitlab.com/dawalters/ocpiupdate@v0.6.0

docker or podman

The containers directory contains a variety of containers, relying only on a local installation of docker or podman.

You can download built containers from the Gitlab Container Registry. This happens automatically when running a registry image without a local copy.

See containers/scripts/ocpiupdate.sh for a script that allows running the ocpiupdate:latest container over more than one project.

To download and use this script:

# If you want to keep a local copy of the script
curl -o ocpiupdate.sh https://gitlab.com/dawalters/ocpiupdate/-/raw/develop/containers/scripts/ocpiupdate.sh
source ocpiupdate.sh

# If you don't want to keep a local copy of the script
source <(curl -s https://gitlab.com/dawalters/ocpiupdate/-/raw/develop/containers/scripts/ocpiupdate.sh)

You can then use the terminal command ocpiupdate in exactly the same way as the python script.

If you have built a local version of the container, then ocpiupdate.sh will use that. Otherwise, it will download the container from the remote registry.

Source tarball

You can download source releases from the Gitlab Releases page.

Configuration

The various functions that ocpiupdate performs are called actions.

You can view all available actions:

ocpiupdate --actions

If you encounter issues with an action, you can disable it:

ocpiupdate \
    --skip-action rename_spec_to_comp \
    --skip-action rename_protocol_to_prot \
    $project

Disclaimer

This repository has no affiliation with OpenCPI.

The maintainer doesn't maintain OpenCPI.