#stream #metadata #derivative #fedora #fetch #parse #information

coreos-stream-metadata

Fetch and parse stream metadata for Fedora CoreOS and derivatives

1 unstable release

0.1.0 Nov 2, 2022

#14 in #fedora

Download history 14/week @ 2023-11-27 28/week @ 2023-12-11 32/week @ 2024-01-01 4/week @ 2024-01-22 18/week @ 2024-01-29 81/week @ 2024-02-26 10/week @ 2024-03-04 39/week @ 2024-03-11

130 downloads per month
Used in zincati

Apache-2.0

12KB
169 lines

Rust library for interacting with CoreOS Stream metadata

See the Fedora CoreOS documentation for basic information about streams.

This is a Rust library which defines standard structs that #[derive(Deserialize)] for use with serde.

Example usage

use anyhow::Result;
use coreos_stream_metadata::Stream;

#[tokio::main]
fn main() -> Result<()> {
  let streamid = coreos_stream_metadata::fcos::StreamId::Stable;
  let arch = "x86_64";
  let region = "us-east-1";
  let buf = reqwest::get(streamid.url())
    .await?
    .bytes()
    .await?;
  let stream: Stream = serde_json::from_slice(&buf)?;
  let ami = stream.architectures.get(arch).unwrap().images.get("aws").unwrap().regions(region).unwrap();
  println!("The AMI for FCOS {} {} is {} (version {})", streamid, region, ami.image, ami.release);
  Ok(())
}

lib.rs:

Library for interacting with CoreOS stream metadata, used by Fedora CoreOS and RHEL CoreOS.

Get the URL for FCOS stable stream:

use coreos_stream_metadata::fcos;
let url = fcos::StreamID::Stable.url();

Deserialize stream data and print URL for OpenStack image

use coreos_stream_metadata::Stream;

let stream: Stream = serde_json::from_reader(std::io::stdin())?;
let openstack = stream.query_thisarch_single("openstack").ok_or_else(|| anyhow::anyhow!("Missing openstack image"))?;
println!("OpenStack image URL: {}", openstack.location);

Dependencies

~0.5–1.1MB
~25K SLoC