ocpiupdate 0.5.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.11 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.10 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.5.0` tag
pip install git+https://gitlab.com/dawalters/ocpiupdate@v0.5.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.

Source tarball

You can download source releases from the Gitlab Releases page.

Configuration

Until documentation becomes available, you can follow the release posts available on the OpenCPI forum.

This includes examples of usage, and discussion of how to write configuration files.

Disclaimer

This repository has no affiliation with OpenCPI.

The maintainer doesn't maintain OpenCPI.