Skip to main content

xOpera TOSCA parser

Project description

xOpera TOSCA parser

TOSCA YAML parser for xOpera orchestrator.

cicd PyPI Test PyPI

Table of Contents


xOpera TOSCA parser aims to be a lightweight parser component compliant with OASIS TOSCA. The current compliance is with the TOSCA Simple Profile in YAML v1.3.

We are also testing experimental support for TOSCA Version 2.0, which will become the main version after TOSCA 2.0 is released.


opera-tosca-parser requires Python 3 and a virtual environment. In a typical modern Linux environment, we should already be set. In Ubuntu, however, we might need to run the following commands:

$ sudo apt update
$ sudo apt install -y python3-venv python3-wheel python-wheel-common

Installation and Quickstart

The orchestration tool is available on PyPI as a package named opera-tosca-parser. Apart from the latest PyPI production version, you can also find the latest PyPI development version, which includes pre-releases so that you will be able to test the latest features before they are officially released.

The simplest way to test opera-tosca-parser is to install it into Python virtual environment:

$ python3 -m venv .venv && . .venv/bin/activate
(.venv) $ pip install opera-tosca-parser

To test if everything is working as expected, you can clone xopera-examples GitHub repository and try to parse a simple hello-world example with the opera-tosca-parser CLI tool that comes along with the TOSCA parser:

(.venv) $ git clone
(.venv) $ cd xopera-examples/misc/hello-world
(.venv) $ opera-tosca-parser parse service.yaml
Parsing service template...

And that is it. The opera orchestrator is available in xopera-opera repository. For more startup examples please visit xopera-examples repository. If you want to use opera commands from an API take a look at xopera-api repository. You can also take a look at the xOpera SaaS component, which is designed for business partners and enterprise users. To find more about xOpera project visit our xOpera documentation.


This work is licensed under the Apache License 2.0.


You can contact the xOpera team by sending an email to


Some work from this project has received funding from the European Union’s Horizon 2020 research and innovation programme under Grant Agreements No. 825040 (RADON), No. 825480 (SODALITE) and No. 101000162 (PIACERE).

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

opera-tosca-parser-0.2.2.tar.gz (127.1 kB view hashes)

Uploaded Source

Built Distribution

opera_tosca_parser-0.2.2-py3-none-any.whl (155.4 kB view hashes)

Uploaded Python 3

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