jira-core 0.4.2

Core library for Jira CLI — API client, auth, model, ADF parser
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# jira-core

Core library for the [jira-commands](https://crates.io/crates/jira-commands) Jira CLI — provides the HTTP client, auth, models, and ADF parser as a reusable Rust library.

[![Crates.io](https://img.shields.io/crates/v/jira-core.svg)](https://crates.io/crates/jira-core)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## Usage

```toml
[dependencies]
jira-core = "0.3"
```

```rust
use jira_core::{JiraClient, JiraConfig};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let config = JiraConfig::load()?;
    let client = JiraClient::new(config);

    // Search issues
    let results = client
        .search_issues("project = MYPROJ AND status = 'In Progress'", None, Some(50))
        .await?;

    for issue in results.issues {
        println!("{}: {}", issue.key, issue.summary);
    }

    // Get a single issue
    let issue = client.get_issue("MYPROJ-123").await?;
    println!("{}", issue.description.unwrap_or_default());

    // Transition an issue
    let transitions = client.get_transitions("MYPROJ-123").await?;
    client.transition_issue("MYPROJ-123", &transitions[0]["id"].as_str().unwrap()).await?;

    // Upload attachment
    client.upload_attachment("MYPROJ-123", "./screenshot.png").await?;

    // Add worklog
    client.add_worklog("MYPROJ-123", "2h", Some("Fixed auth bug")).await?;

    Ok(())
}
```

## Features

- `JiraClient` — full Jira REST API v3 client
  - Issue CRUD (create, read, update, delete, transition)
  - JQL search with cursor-based pagination (`/search/jql`)
  - Attachment upload (multipart/form-data)
  - Worklog management
  - Bulk operations and archive
  - Raw API passthrough
  - Plans API (Jira Premium)
- `JiraConfig` — config loading from file (`~/.config/jira/config.toml`) and env vars
- `FieldCache` — in-memory field metadata cache with TTL
- ADF parser — Atlassian Document Format ↔ Markdown conversion
- `thiserror`-based error types

## Auth

Credentials are loaded automatically from `~/.config/jira/config.toml` (managed by `jira auth login`) or from environment variables:

```bash
JIRA_URL=https://yourcompany.atlassian.net
JIRA_EMAIL=you@example.com
JIRA_TOKEN=your_api_token
```

## Full documentation

See [github.com/mulhamna/jira-commands](https://github.com/mulhamna/jira-commands).