new post: Create GitHub releases with Rust using Hubcaps

_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=<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