Atlassian Jira Client for Scala
This library exposes two types of client
JiraSingleTenantClient
for authentication using api token and basic auth.JiraMultiTenantClient
for Atlassian Connect add-on and OAuth(not supported yet).
To initialize the client with authentication using ApiToken
or BasicAuthentication
import cats.Id
import com.allantl.jira4s.auth.{ApiToken, BasicAuthentication}
import com.allantl.jira4s.v2.JiraSingleTenantClient
import com.softwaremill.sttp.HttpURLConnectionBackend
object Jira4S extends App {
implicit val sttpBackend = HttpURLConnectionBackend()
// ApiToken
val client: JiraSingleTenantClient[Id] = JiraSingleTenantClient(
ApiToken(
"jiraUrl",
"email",
"apiToken"
)
)
// Basic Auth
val client2: JiraSingleTenantClient[Id] = JiraSingleTenantClient(
BasicAuthentication(
"jiraUrl",
"email",
"password"
)
)
val issue = client.getIssue("10000")
}
If you are developing an Atlassian Connect add-on
import cats.Id
import com.allantl.jira4s.auth.{AcJwtConfig, AuthContext}
import com.allantl.jira4s.v2.JiraMultiTenantClient
import com.softwaremill.sttp.HttpURLConnectionBackend
object Jira4S extends App {
implicit val sttpBackend = HttpURLConnectionBackend()
val jwtExpirationInSeconds = 5L
val client: JiraMultiTenantClient[Id] = JiraMultiTenantClient(
AcJwtConfig(
"addOnKey",
jwtExpirationInSeconds
)
)
// You need to specify an implicit AuthContext when making a request to Jira
case class UserCtx(instanceUrl: String, accessToken: String) extends AuthContext
implicit val userCtx = UserCtx(
"http://your-domain.atlassian.net",
"atlassian-host-shared-secret"
)
val issue = client.getIssue("10000")
}
You can add configuration using environment variables or HOCON in application config. Then, you can initialize the client with
import com.allantl.jira4s.v2.{JiraMultiTenantClient, JiraSingleTenantClient}
import com.softwaremill.sttp.HttpURLConnectionBackend
object Jira4S extends App {
implicit val sttpBackend = HttpURLConnectionBackend()
val singleTenantClient = JiraSingleTenantClient()
val multiTenantClient = JiraMultiTenantClient()
}
jira4s {
jira-url = "https://your-domain.atlassian.net"
username = "username"
api-token = "api-token"
}
Environment Variables:
export JIRA4S_JIRA_URL = "https://your-domain.atlassian.net"
export JIRA4S_USERNAME = "username"
export JIRA4S_API_TOKEN = "api-token"
jira4s {
jira-url = "https://your-domain.atlassian.net"
username = "username"
password = "password"
}
Environment Variables:
export JIRA4S_JIRA_URL = "https://your-domain.atlassian.net"
export JIRA4S_USERNAME = "username"
export JIRA4S_PASSWORD = "password"
jira4s {
add-on-key = "Your add on key"
jwt-expiration-in-seconds = 5
}
Environment Variables:
export JIRA4S_ADD_ON_KEY = "Your add on key"
export JIRA4S_JWT_EXPIRATION_IN_SECONDS = 5
Sttp supports different type of backends which return different type of effects. Please take a look at sttp docs.
To add logging to the client, please refer here.