1
Fork 0
blog/_posts/2016-02-23-create-releases-using-hubcaps-a-rust-library.md

71 lines
2.5 KiB
Markdown
Raw Normal View History

---
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=<your token here>`)
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