Initial support for creating Check Runs

Author: Keno

README.md

@@ -218,6 +218,11 @@ GitHub.jl implements a bunch of methods that make REST requests to GitHub's API.
 | `installations(auth)`                    | `Vector{Installation}`             | [get the installations for the GitHub app authenticated by the corresponding `auth`](https://developer.github.com/v3/apps/#find-installations)   |
 | `repos(i::Installation)`                 | `Tuple{Vector{Repo}, Dict}`        | [get the active repositories for this installation](https://developer.github.com/v3/apps/#find-installations)   |
 
+#### GitHub Check Runs
+| method                                   | return type                        | documentation                                                                                                                                                                                               |
+|------------------------------------------|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `create_check_run(repo; params=...)`     | `CheckRun`                         | [Create a new check run](https://developer.github.com/v3/checks/runs/#create-a-check-run)   |
+
 
 #### Miscellaneous
 

src/GitHub.jl

@@ -242,6 +242,7 @@ export # events/listeners.jl
 
 include("apps/apps.jl")
 include("apps/installations.jl")
+include("apps/checks/runs.jl")
 
 # export -------
 
@@ -254,6 +255,10 @@ export # installations.jl
        create_access_token,
        installations
 
+export # runs.jl
+       Checks,
+       create_check_run
+
 #######
 # Git #
 #######

src/apps/checks/runs.jl

@@ -0,0 +1,56 @@
+module Checks
+    export Action, Image, Annotation, Output
+
+    struct Action
+        label::String
+        description::String
+        identifier::String
+    end
+
+    struct Image
+        alt::String
+        image_url::String
+        caption::Nullable{String}
+    end
+
+    struct Annotation
+        filename::String
+        blob_href::String
+        start_line::Int
+        end_line::Int
+        warning_level::String
+        message::String
+        title::Nullable{String}
+        raw_details::String # Documented as Nullable{String}, but that errors
+    end
+
+    struct Output
+        title::String
+        summary::String
+        text::String # Documented as Nullable{String}, but that errors
+        annotations::Vector{Annotation}
+        images::Vector{Image}
+    end
+
+end
+using .Checks
+
+struct CheckRun <: GitHubType
+    id::Nullable{Int}
+    head_sha::Nullable{String}
+    external_id::Nullable{String}
+    status::Nullable{String}
+    conclusion::Nullable{String}
+    started_at::Nullable{DateTime}
+    completed_at::Nullable{DateTime}
+    app::Nullable{App}
+    pull_requests::Vector{PullRequest}
+end
+CheckRun(data::Dict) = json2github(CheckRun, data)
+namefield(cr::CheckRun) = cr.id
+
+@api_default function create_check_run(api::GitHubAPI, repo::Repo; headers = Dict(), kwargs...)
+    headers["Accept"] = "application/vnd.github.antiope-preview+json"
+    result = gh_post_json(api, "/repos/$(name(repo))/check-runs"; headers=headers, kwargs...)
+    return CheckRun(result)
+end