com.jcabi.github

Interface Gists

@Immutable
public interface Gists

Github gists.

Since:

0.1

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

See Also:

Gists API

To do:

#1:1hr New method remove() to delete a gist. Let's add a new method to remove a gist by name, as explained in http://developer.github.com/v3/gists/#delete-a-gist. The method should be tested by unit and integration tests.

Method Summary

Methods

Modifier and Type	Method and Description
Gist	create(Iterable<String> files) Create a new gist.
Gist	get(String name) Get gist by name.
Github	github() Github we're in.
Iterable<Gist>	iterate() Iterate all gists.

Method Detail

github

@NotNull(message="Github is never NULL")
Github github()

Github we're in.

Returns:

Github

create

@NotNull(message="gist is never NULL")
Gist create(@NotNull(message="list of files can\'t be NULL")
                         Iterable<String> files)
            throws IOException

Create a new gist.

Parameters:

files - Names of files

Returns:

Gist

Throws:

IOException - If there is any I/O problem

See Also:

Create a Gist

get

@NotNull(message="gist is never NULL")
Gist get(@NotNull(message="name can\'t be NULL")
                      String name)

Get gist by name.

Parameters:

name - Name of it

Returns:

Gist

See Also:

Get a Single Gist

iterate

@NotNull(message="iterable is never NULL")
Iterable<Gist> iterate()

Iterate all gists.

Returns:

Iterator of gists

See Also:

List Gists