diff --git a/_posts/2016-02-23-create-releases-using-hubcaps-a-rust-library.md b/_posts/2016-02-23-create-releases-using-hubcaps-a-rust-library.md new file mode 100644 index 0000000..5b237a1 --- /dev/null +++ b/_posts/2016-02-23-create-releases-using-hubcaps-a-rust-library.md @@ -0,0 +1,70 @@ +--- +layout: post +title: Create GitHub releases with Rust using Hubcaps +date: 23.02.2016 20:32 +--- + +For one of my projects I need to access the GitHub API to create releases. +Luckily, through reading [This Week in Rust #119][twir], I discovered [Hubcaps][], a library for interfacing with GitHub. + +Though it lacks some documentation and is not yet fully finished, it already provides APIs for the relevant parts regarding releases. + +On GitHub a release is always associated with a [Git tag][gittag], but need to be specifially created to be shown on the site with the full description and optional assets attached to them. +It is also possible to mark releases as a draft (then it is only visible to repo contributors) or as a pre-release, useful for alpha releases of a library or application. + +Once you have a Git tag in your repository the API can be used to create an associated release using the following Rust code: + + +~~~rust +extern crate hyper; +extern crate hubcaps; + +use std::{env, process}; +use hyper::Client; +use hubcaps::{Github, ReleaseOptions}; + +fn main() { + let token = match env::var("GITHUB_TOKEN").ok() { + Some(token) => token, + _ => { + println!("example missing GITHUB_TOKEN"); + process::exit(1); + } + }; + + let client = Client::new(); + let github = Github::new("hubcaps/0.1.1", &client, Some(token)); + + let user = "username"; + let repo = "my-library"; + let name = "ONE DOT OH"; + let body = "This is a long long body"; + let tag = "v1.0.0"; + + let opts = ReleaseOptions::builder(tag) + .name(name) + .body(body) + .commitish("master") + .draft(false) + .prerelease(false) + .build(); + + let repo = github.repo(user, repo); + let release = repo.releases(); + match release.create(&opts) { + Ok(_) => println!("Release created"), + Err(e) => println!("Failed to create release: {:?}", e), + }; +} +~~~ + +If you clone [Hubcaps][] and put the above code in a file named `releases.rs` into the `examples/` folder, you can run it with `cargo run --example releases`. +You need to get a [personal access token](https://github.com/settings/tokens) first and set it in your environment (`export GITHUB_TOKEN=`) + +Of course it has the repository and tag hard-coded, but this is easy to adapt. + +_The code was tested with Rust 1.6 and hubcaps 0.1.1_ + +[twir]: https://this-week-in-rust.org/blog/2016/02/22/this-week-in-rust-119/ +[hubcaps]: https://github.com/softprops/hubcaps +[gittag]: https://git-scm.com/book/en/v2/Git-Basics-Tagging