Garden Linux Python Library

Python tooling to work with Garden Linux features, flavors, OCI artifacts, repositories, and releases. It is primarily targeted at Garden Linux developers and CI pipelines rather than end users.

The library follows the intent of Semantic Versioning for its public APIs.

Features

• Feature management: parse, filter, and work with Garden Linux feature sets
• Flavor processing: parse flavors.yaml and generate flavor combinations
• Repository utilities: compare APT repositories and query package versions
• OCI operations: push OCI artifacts and manifests to container registries
• S3 integration: upload/download artifacts from S3 buckets
• GitHub integration: create and manage GitHub releases

Documentation

Full documentation is available at the Garden Linux Python Library Documentation site: https://gardenlinux.github.io/python-gardenlinux-lib/

The docs include:

• Command-Line Interface: gl-features-*, gl-flavors-*, gl-oci, gl-s3, gl-gh-release
• API Reference: modules, classes, and functions (e.g. Parser, CName, Container, Repository)
• Release documentation: versioning and release process

Installation

Using poetry (from Git)

Add the library as a dependency in your pyproject.toml:

[tool.poetry.dependencies]
gardenlinux = { git = "https://github.com/gardenlinux/python-gardenlinux-lib", rev = "0.10.5" }

Then install:

poetry install

Local development setup

git clone https://github.com/gardenlinux/python-gardenlinux-lib.git
cd python-gardenlinux-lib
python -m venv venv
source venv/bin/activate
poetry install

Quickstart

Example: list features for a given cname

from gardenlinux.features import Parser

cname = "aws-gardener_prod"
feature_list = Parser().filter_as_list(cname)

print(f"features of {cname}:")
for feature in feature_list:
    print(feature)

For more examples and for all CLI tools, see the Command-Line Interface and API Reference sections in the docs: https://gardenlinux.github.io/python-gardenlinux-lib/