launchpadlib is both an executable binary that can be run, and a library that can be used in Rust programs.
Installing lp-attach lp-check-membership lp-list-bugs lp-set-dupe executables
Assuming you have Rust/Cargo installed , run this command in a terminal:
cargo install launchpadlibIt will make lp-attach lp-check-membership lp-list-bugs lp-set-dupe commands available in your PATH if you've allowed the PATH to be modified when installing Rust . cargo uninstall launchpadlib uninstalls.
Adding launchpadlib library as a dependency
Run this command in a terminal, in your project's directory:
cargo add launchpadlibTo add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:
launchpadlib = "0.5.7"The launchpadlib library will be automatically available globally.
Read the launchpadlib library documentation
Back to the crate overview .
Readme
Rust bindings for the Launchpad API
Example:
use launchpadlib:: Resource;
use launchpadlib:: v1_0:: ServiceRoot;
fn main ( ) {
use url:: Url;
let client = launchpadlib:: Client:: anonymous( " just+testing" ) ;
let service_root = launchpadlib:: v1_0:: service_root( & client) . unwrap ( ) ;
let people = service_root. people ( ) . unwrap ( ) ;
let person = people. get_by_email ( & client, " jelmer@jelmer.uk" ) . unwrap ( ) ;
let ssh_keys = person. sshkeys ( & client) . unwrap ( ) . map ( | k | k. keytext ) . collect:: < Vec < _ > > ( ) ;
println! ( " SSH Keys: {:?} " , ssh_keys) ;
} Bindings are generated from the wadl published by Launchpad.
Feature Flags
The library supports feature flags for Launchpad's different "pillars" to reduce build times:
bugs answers blueprints code translations packages vulnerabilities
By default, all pillar features are enabled. To reduce build times, you can disable features you don't need:
[ dependencies ]
launchpadlib = { version = "0.5", default-features = false, features = [ " blocking" " api-v1_0" " bugs" ] This can reduce build times significantly.
Note: Resources that span multiple pillars (e.g., linking bugs to branches) require all relevant pillar features to be enabled.
Limitations and bugs
While bindings are generated from the entire WADL file, I have only used a
small number of them. Please report bugs if you run into issues.
Launchpad's WADL is incorrect in places, e.g. claiming that certain fields
are optional while they will actually be set to null. Any problems with the
WADL will impact the usability of the rust bindings.
See fixup.xsl for manual patches that are applied; this file is
almost certainly incomplete.