Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mattweldon/exjira

JIRA client library for Elixir
https://github.com/mattweldon/exjira

Last synced: about 2 months ago
JSON representation

JIRA client library for Elixir

Lists

README

        

# ExJira

A JIRA client library for Elixir using erlang-oauth to call the JIRA REST API.

A non-trivial project to help me get started using Elixir - Currently WIP.

### Usage

#### 1. Add dependencies

Add the following to the deps section in `mix.exs`.

```elixir
defp deps do
[
{:oauth, github: "tim/erlang-oauth"},
{:extwitter, "~> 0.1"}
]
end
```

#### 2. Setup OAuth parameters

Use `ExJira.configure` to setup the JIRA OAuth parameters. See the Configuration section below for further details.

#### 3. Access JIRA endpoints

Call the functions in the ExJira module (e.g. `ExJira.projects` to return all projects or `ExJira.project("KEY")` to return a specifc one).

### Configuration

There are three ways to configure ExJira:

#### Using config.exs

In `config/config.exs` add the following:

```elixir
config :ex_jira, [
site: "http://youraccount.atlassian.net",
private_key_file: "private_key.pem"
consumer_key: ""
]
```

#### Across the application at runtime

```elixir
ExJira.configure([consumer_key: "", ...])
```

#### For the current process at runtime

```elixir
ExJira.configure(:process, [consumer_key: "", ...])
```