Struct Jira 

pub struct Jira { /* private fields */ }

Jira client with cached-session management via the Session trait.

Implementations

impl Jira

pub fn new(config: &JiraConfig) -> Self

Builds a client from the config; no network activity yet.

use kasl::api::jira::{Jira, JiraConfig};

let config = JiraConfig {
    login: "username".to_string(),
    api_url: "https://jira.company.com".to_string(),
    completed_statuses: Vec::new(),
};
let jira = Jira::new(&config);

pub async fn get_completed_issues( &mut self, date: &NaiveDate, ) -> Result<Vec<JiraIssue>>

Fetches the user’s issues resolved on date (full-day range).

A 401 drops the cached session and retries up to the limit; other failures propagate - completed issues feed the report, so a silent empty result would hide real problems.

let config = JiraConfig {
    login: "username".to_string(),
    api_url: "https://jira.company.com".to_string(),
    completed_statuses: Vec::new(),
};
let mut jira = Jira::new(&config);

let today = chrono::Local::now().date_naive();
let issues = jira.get_completed_issues(&today).await?;

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

pub async fn get_assigned_open_issues( &mut self, extra_field_ids: &[String], ) -> Result<Vec<JiraIssue>>

Fetches open issues currently assigned to the authenticated user.

Uses JQL assignee = currentUser() AND resolution is EMPTY. Paginates through all matching issues (startAt / total). Extra field ids (custom fields such as Scoring) are included in the fields query.

A poll that fails is an error, never an empty list. The caller reconciles the inbox against whatever comes back, so an empty answer for a dropped VPN would mark every issue gone - and the next good poll would bring all of them “back”, one change toast per issue.

pub async fn get_assigned_open_issues_noninteractive( &mut self, extra_field_ids: &[String], ) -> Result<Option<Vec<JiraIssue>>>

Like [get_assigned_open_issues], but never prompts for a password.

Uses a cached session cookie and/or the keyring secret. Returns Ok(None) when neither is available so background daemons can skip the poll without blocking on stdin. A poll that fails is an error, for the same reason as in [get_assigned_open_issues]: the daemon must skip the reconcile, not reconcile against nothing.

pub fn open_issues_url(&self) -> String

Builds the issue-navigator URL listing the user’s open issues.

Summary toasts point here: they speak for many issues at once, so no single browse URL fits.

pub fn issue_browse_url(&self, key: &str) -> String

Builds a browse URL for an issue key using this client’s API base.

pub fn priority_rank(priority: &Option<JiraPriority>) -> i32

Maps a Jira priority id to a sortable rank (lower = more urgent).

pub fn extract_number(value: &Value) -> Option<f64>

Extracts a numeric value from a Jira custom-field JSON value.

Supports bare numbers, numeric strings, and objects with value / amount.

pub fn sort_value_from_issue(issue: &JiraIssue, field_id: &str) -> Option<f64>

Reads a numeric custom field from issue extras by field id.

Trait Implementations

impl Debug for Jira

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Session for Jira

async fn login(&self) -> Result<String>

Logs in and returns the session cookie as name=value.

fn set_credentials(&mut self, password: &str) -> Result<()>

Stores the password (encoded as the provider requires) for login.

fn session_id_file(&self) -> &str

Per-provider session cache filename.

fn secret(&self) -> Secret

Per-provider secret manager (prompt text, cache file).

fn retry(&self) -> i32

Current failed-attempt count.

fn inc_retry(&mut self)

Bumps the failed-attempt count.

fn reset_retry(&mut self)

Clears the failed-attempt count after a successful login.

async fn get_session_id(&mut self) -> Result<String>

Returns a session id: cached if available, otherwise via login with up to [MAX_RETRY_COUNT] password attempts (a retry always re-prompts rather than reusing a password that just failed).

fn read_session_id(file_name: &str) -> Result<String>

Reads the cached session id.

fn write_session_id(file_name: &str, session_id: &str) -> Result<()>

Writes the session id to the cache file.

fn delete_session_id(&self) -> Result<()>

Drops the cached session, forcing a fresh login next time.