pius / tentacat

Simple Elixir wrapper for the GitHub API

Tentacat

Simple Elixir wrapper for the GitHub API.

Tentacool + Cat = Tentacat

Elixir 0.9.3 required

Features

• Gitignore
• Organizations
  • Members
• Users
  • Emails
  • Keys

Documentation can be found here

Quickstart

Fetching dependencies and running on elixir console:

mix deps.get
iex -S mix

You will something like this:

Erlang R16B (erts-5.10.1) [source] [64-bit] [smp:4:4] [async-threads:10] [hipe]

Interactive Elixir (0.9.3) - press Ctrl+C to exit (type h() ENTER for help)
iex(1)>

Now you can run the examples!

Examples

Every call to GitHub need a client, but if you want to use unauthenticated requests we will provide it for you. Keep in mind that GitHub have different rate-limits if you authenticate or not.

Getting info from a user using a client

iex> client = Tentacat.Client.new
Tentacat.Client[auth: nil]
iex> Tentacat.Users.find "edgurgel", client
[{"login","edgurgel"},{"id",30873},{"avatar_url","https://secure.gravatar.com/avatar/5e0f65b214819fedf529220e19c08908?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png"},{"gravatar_id","5e0f65b214819fedf529220e19c08908"},{"url","https://api.github.com/users/edgurgel"},{"html_url","https://github.com/edgurgel"},{"followers_url","https://api.github.com/users/edgurgel/followers"},{"following_url","https://api.github.com/users/edgurgel/following{/other_user}"},{"gists_url","https://api.github.com/users/edgurgel/gists{/gist_id}"},{"starred_url","https://api.github.com/users/edgurgel/starred{/owner}{/repo}"},{"subscriptions_url","https://api.github.com/users/edgurgel/subscriptions"},{"organizations_url","https://api.github.com/users/edgurgel/orgs"},{"repos_url","https://api.github.com/users/edgurgel/repos"},{"events_url","https://api.github.com/users/edgurgel/events{/privacy}"},{"received_events_url","https://api.github.com/users/edgurgel/received_events"},{"type","User"},{"name","Eduardo Gurgel"},{"company","Codeminer 42"},{"blog","http://gurgel.me"},{"location","Fortaleza, Brazil"},{"email","[e-mail]"},{"hireable",false},{"bio",nil},{"public_repos",19},{"followers",16},{"following",38},{"created_at","2008-10-24T17:05:04Z"},{"updated_at","2013-06-18T22:52:41Z"},{"public_gists",4}]

Getting info from a user without a defined client

iex> Tentacat.Users.find "edgurgel" |> ListDict.get "email"
"[e-mail]"

Getting info from the authenticated user

• Using user and password:

iex> client = Tentacat.Client.new(auth: [user: "user", password: "password"])
Tentacat.Client[auth: [user: "user", password: "password"]]
iex> Tentacat.Users.me(client)

• Using a personal access token Github personal API token

iex> client = Tentacat.Client.new(auth: [access_token: "928392873982932"])
Tentacat.Client[auth: [access_token: "928392873982932"]]
iex> Tentacat.Users.me(client)

Contributing

Start by forking this repo

Then run this command to fetch dependencies and run tests:

MIX_ENV=test mix do deps.get, test

Pull requests are greatly appreciated