Skip to main content

Bupy

The Butane Python Toolkit

Bupy was built to help users develop Butane configurations for Fedora CoreOS quickly on their workstations. It allows you to convert Butane YAML to Ignition JSON and render Butane Jinja2 templates to either Butane YAML or Ignition JSON. You can then use your Butane file or template to launch a local QEMU Virtual Machine.

Requirements

Roadmap

  • Convert Support

  • Jinja2 Template Support

  • Launch a local QEMU FCOS VM

  • Merge Butane YAML (snippets)

  • Serve Ignition JSON via HTTP

  • Libvirt support

Demo

You can watch a quick demo of Bupy on Youtube.

Quick demo of Bupy for Fedora CoreOS

Development

  1. Clone this repo
  2. Install dependencies
poetry install
  1. Activate a poetry shell
poetry shell
  1. Make changes...
  2. See them in action
bupy --help

 Usage: bupy [OPTIONS] COMMAND [ARGS]...

 Bupy: Butane Python toolkit.

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --version             -v        Show the version and exit.                                                                                                                                                 │
│ --install-completion            Install completion for the current shell.                                                                                                                                  │
│ --show-completion               Show completion for the current shell, to copy it or customize the installation.                                                                                           │
│ --help                          Show this message and exit.                                                                                                                                                │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ convert                      Converts Butane YAML to Ignition JSON                                                                                                                                         │
│ template                     Renders a Jinja2 Template to Butane YAML or Ignition JSON                                                                                                                     │
│ vm                           Launches a QEMU VM with a Butane YAML or Jinja2 Template                                                                                                                      │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

 Made in ✶✶✶✶ Chicago✶✶✶✶  〜 (c) 2023 QuickVM, LLC

License

Apache License Version 2.0

Copyright 2023 QuickVM, LLC

Metadata

Release files for bupy 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bupy 0.1.2
File Size Uploaded Provenance Actions
bupy-0.1.2.tar.gz 13.6 kB Without provenance Details for bupy-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bupy 0.1.2
File Interpreter ABI Platform Actions
bupy-0.1.2-py3-none-any.whl Python 3 none any Details for bupy-0.1.2-py3-none-any.whl

Total release size: 28.7 kB

Release files / bupy-0.1.2.tar.gz

Download URL bupy-0.1.2.tar.gz
Size 13.6 kB
Tags Source
SHA-256 checksum
How to use checksums
cedde01c766be2cad2fbd9515d08dc9c7e52c379d423c791afe95414fadd0221
BLAKE2b-256 checksum
How to use checksums
a227d567a7187511f04746066bfe1dd790da5eea9acdca23d450467d207aef26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.4.1 CPython/3.11.4 Linux/6.4.2-201.fc38.x86_64

Release files / bupy-0.1.2-py3-none-any.whl

Download URL bupy-0.1.2-py3-none-any.whl
Size 15.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d59327b57270db59195906efea597951090a60a3a691c179138bb776f7551826
BLAKE2b-256 checksum
How to use checksums
171d3745647bd087d102c2f0e0ffada5f29439c299920f385e33f98b96a5cdce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.4.1 CPython/3.11.4 Linux/6.4.2-201.fc38.x86_64

Security for bupy 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page