atlassian.config — net.clojars.deadmeme5441/atlassian-sdk 0.2.0

Configuration + auth resolution for the Atlassian Cloud APIs.

Pure where it matters: this namespace reads environment variables (and an optional local, gitignored .env) into compact config maps and reports whether auth is ready WITHOUT making any network call. URL bases and the Authorization header are constructed here so the HTTP layer stays a dumb transport.

No secrets are ever written to tracked files. .env is gitignored.

auth-header clj

(auth-header cfg)

Authorization header value. Cloud uses Basic base64(email:token); Data Center uses a Bearer personal access token.

confluence-auth-status clj

(confluence-auth-status)

(confluence-auth-status cfg)

Report whether required Confluence config is present. NEVER hits the network.

confluence-config clj

(confluence-config)

(confluence-config env-or-fn)

Build the Confluence config map from the environment. Because Confluence Cloud lives on the SAME site and uses the SAME API token as Jira, the resolver falls back to the Jira variables when Confluence-specific ones are absent:

CONFLUENCE_BASE_URL | JIRA_BASE_URL (site origin; /wiki optional) CONFLUENCE_USER_EMAIL | CONFLUENCE_EMAIL | JIRA_USER_EMAIL | JIRA_EMAIL CONFLUENCE_API_TOKEN | CONFLUENCE_API_KEY | JIRA_API_TOKEN | JIRA_API_KEY CONFLUENCE_INSTANCE_TYPE = cloud | datacenter (default cloud)

Pass a {"VAR" val} map (or resolver fn) to bypass the real environment.

confluence-v1-base clj

(confluence-v1-base cfg)

Root of the Confluence Cloud REST API v1, e.g. https://x.atlassian.net/wiki/rest/api

confluence-v2-base clj

(confluence-v2-base cfg)

Root of the Confluence Cloud REST API v2, e.g. https://x.atlassian.net/wiki/api/v2

env-resolver clj

(env-resolver)

(env-resolver dotenv getenv)

Return a lookup fn (f "VAR") -> value-or-nil resolving process env over an optional .env file (process env wins). Pass overrides for testing.

issue-browse-url clj

(issue-browse-url cfg issue-key)

Human browser URL for an issue, e.g. https://x.atlassian.net/browse/ABC-123

jira-agile-base clj

(jira-agile-base cfg)

Root of the Jira Software Agile REST API, e.g. https://x.atlassian.net/rest/agile/1.0 (same path on Cloud and Data Center).

jira-api-base clj

(jira-api-base cfg)

Root of the Jira platform REST API, e.g. https://x.atlassian.net/rest/api/3

jira-auth-status clj

(jira-auth-status)

(jira-auth-status cfg)

Report whether required Jira config is present. NEVER hits the network.

Cloud auth needs base-url + email + token (Basic). Data Center PAT auth needs only base-url + token (Bearer). Returns a map with :configured? and the list of :missing variable names — :token itself is never echoed back.

jira-config clj

(jira-config)

(jira-config env-or-fn)

Build the Jira config map from the environment (process env overlaid on a local .env). Accepts alternate variable names so it works against either the spec'd names or a typical Cloud .env:

JIRA_BASE_URL JIRA_USER_EMAIL | JIRA_EMAIL | JIRA_USER JIRA_API_TOKEN | JIRA_API_KEY JIRA_INSTANCE_TYPE = cloud | datacenter (default cloud) JIRA_API_VERSION (default 3 cloud, 2 datacenter)

Pass a {"VAR" val} map (or a resolver fn) to bypass the real environment — this is the seam tests use, so no test ever needs live credentials.

jira-software-base clj

(jira-software-base cfg)

Root of the enhanced Jira Software API (enhanced sprint/epic endpoints), e.g. https://x.atlassian.net/rest/software/1.0.

load-dotenv clj

(load-dotenv)

(load-dotenv path)

Parse a .env-style file into a {"VAR" "value"} map. Returns {} if the file is absent or unreadable. Tolerates export, single/double quotes, blank lines, and # comment lines. Never throws — a missing .env is normal.