Skip to main content

A collection of experimental BuildStream plugins.

Project description

IMPORTANT: This project will be renamed soon to buildstream-plugins-community

A collection of “experimental” plugins for BuildStream 2.0.

This repo collects plugins which don’t provide the strong API guarantees required by the buildstream-plugins project.

How to use this repo

The plugins in this repo do not provide strong API guarantees or backwards compatibility. You should use a specific commit in your project and update it manually as needed.

You are recommended to import these plugins into your project using the junction plugins feature of BuildStream 2.0 so you can control exactly what Git commit is used. This is done in several stages documented below:

Using via a junction

First, make sure you have the git source from buildstream-plugins available and declared in your project.conf file. If you installed the PyPI package then you can import it as a pip plugin:

- origin: pip
  package-name: buildstream-plugins
  - git

Now, add a junction element referencing this repo. Here’s an example you could save as bst-plugins-experimental.bst in your elements directory:

kind: junction

- kind: git
  track: master

You can then run bst source track bst-plugins-experimental.bst to set the ref field appropriately.

Finally you can define specific plugins you want to use in project.conf:

- origin: junction
  junction: bst-plugins-experimental.bst
  - pypi
  - pep517

Alternative methods

You can use Git’s ‘submodules’ feature to import this repo into your project’s repo, then declare the plugins as local plugins.

BuildStream also supports pip plugins which are imported from the host Python environment. While bst-plugins-experimental is available on PyPI, the project does not provide any backwards compatibility or “semantic versioning” guarantees. Make sure you can control exactly what of the package version is used if you consume it via Pip.

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

bst_plugins_experimental-1.100.1.tar.gz (81.3 kB view hashes)

Uploaded Source

Built Distribution

bst_plugins_experimental-1.100.1-py2.py3-none-any.whl (113.1 kB view hashes)

Uploaded Python 2 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