Struct IssueDoc 

pub struct IssueDoc {
    pub project: String,
    pub path: PathBuf,
    pub preamble: String,
    pub headings: Vec<IssueHeading>,
}

One project’s issues.org: a preamble followed by top-level headings.

Fields

project: String

Project directory name this file belongs to.

path: PathBuf

Path of the issues.org this document was parsed from or will write to.

preamble: String

File header above the first heading, including #+TODO:.

headings: Vec<IssueHeading>

Top-level issue headings, in file order.

Implementations

impl IssueDoc

pub fn empty(project: &str, path: PathBuf) -> Self

An empty document with the house preamble and no headings.

pub fn parse_file(project: &str, path: &Path) -> Result<Self>

Parse path, or produce an empty document when the file is absent.

Errors

Returns an error if the file exists but cannot be read or parsed.

pub fn parse(project: &str, path: PathBuf, content: &str) -> Result<Self>

Parse content as an issues.org for project.

Errors

Returns an error if a heading has an unknown TODO keyword or no :ID:.

pub fn write(&self) -> Result<()>

Render and replace the file through a uniquely named temporary. Callers hold with_issues_lock around the parse and this write.

Errors

Returns an error if the parent directory cannot be created, the temporary cannot be written, or the rename cannot publish it.

pub fn known_ids(&self) -> Vec<String>

Every heading id in this document, in file order.

pub fn upsert(&mut self, heading: IssueHeading)

Replace a heading with the same id, or append if none matches.

pub fn remove(&mut self, id: &str) -> Option<IssueHeading>

Remove the heading with id, if it is in this document.

Trait Implementations

impl Clone for IssueDoc

fn clone(&self) -> IssueDoc

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IssueDoc

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

Formats the value using the given formatter.