Class: Doing::WWID

Inherits:
Object
  • Object
show all
Includes:
Color
Defined in:
lib/doing/wwid.rb

Overview

Main "What Was I Doing" methods

Constant Summary

Constants included from Color

Color::ATTRIBUTES, Color::ATTRIBUTE_NAMES, Color::COLORED_REGEXP

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Color

attributes, coloring?, #support?, #uncolor

Constructor Details

#initialize ⇒ WWID

Initializes the object.

Instance Attribute Details

#additional_configs ⇒ Object (readonly)

Returns the value of attribute additional_configs.

#auto_tag ⇒ Object

Returns the value of attribute auto_tag.

#config ⇒ Object

Returns the value of attribute config.

#config_file ⇒ Object

Returns the value of attribute config_file.

#content ⇒ Object (readonly)

Returns the value of attribute content.

#current_section ⇒ Object (readonly)

Returns the value of attribute current_section.

#default_option ⇒ Object

Returns the value of attribute default_option.

#doing_file ⇒ Object (readonly)

Returns the value of attribute doing_file.

Instance Method Details

#act_on(items, opt = {}) ⇒ Object

Perform actions on a set of entries. If no valid action is included in the opt hash and the terminal is a TTY, a menu will be presented

Parameters:

  • items (Array) —

    Array of Items to affect

  • opt (Hash) (defaults to: {}) —

    Options and actions to perform

Options Hash (opt):

  • :editor (Boolean)
  • :delete (Boolean)
  • :tag (String)
  • :flag (Boolean)
  • :finish (Boolean)
  • :cancel (Boolean)
  • :archive (Boolean)
  • :output (String)
  • :save_to (String)
  • :again (Boolean)
  • :resume (Boolean)

#add_item(title, section = nil, opt = {}) ⇒ Object

Adds an entry

Parameters:

  • title (String) —

    The entry title

  • section (String) (defaults to: nil) —

    The section to add to

  • opt (Hash) (defaults to: {}) —

    Additional Options

Options Hash (opt):

  • :date (Date) —

    item start date

  • :note (Array) —

    item note (will be converted if value is String)

  • :back (Date) —

    backdate

  • :timed (Boolean) —

    new item is timed entry, marks previous entry as @done

#all_tags(items, opt: {}) ⇒ Object

#archive(section = @config['current_section'], options = {}) ⇒ Object

Move entries from a section to Archive or other specified section

Parameters:

  • section (String) (defaults to: @config['current_section']) —

    The source section

  • options (Hash) (defaults to: {}) —

    Options

#autotag(text) ⇒ Object

Uses 'autotag' configuration to turn keywords into tags for time tracking. Does not repeat tags in a title, and only converts the first instance of an untagged keyword

Parameters:

  • text (String) —

    The text to tag

#choose_section ⇒ String

Generate a menu of sections and allow user selection

Returns:

  • (String) —

    The selected section name

#choose_view ⇒ String

Generate a menu of views and allow user selection

Returns:

  • (String) —

    The selected view name

#create(filename = nil) ⇒ Object

Create a new doing file

#dedup(items, no_overlap: false) ⇒ Object

Remove items from a list that already exist in @content

Parameters:

  • items (Array) —

    The items to deduplicate

  • no_overlap (Boolean) (defaults to: false) —

    Remove items with overlapping time spans

#edit_last(section: 'All', options: {}) ⇒ Object

Edit the last entry

Parameters:

  • section (String) (defaults to: 'All') —

    The section, default "All"

#filter_items(items = Items.new, opt: {}) ⇒ Object

Filter items based on search criteria

Parameters:

  • items (Array) (defaults to: Items.new) —

    The items to filter (if empty, filters all items)

  • opt (Hash) (defaults to: {}) —

    The filter parameters

Options Hash (opt:):

  • :section (String)
  • :unfinished (Boolean)
  • :tag (Array or String) — default: Array or comma-separated string
  • :tag_bool (Symbol) — default: :and, :or, :not
  • :search (String) — default: string, optional regex with //
  • :date_filter (Array) —

    [[Time]start, [Time]end]

  • :only_timed (Boolean)
  • :before (String) — default: Date/Time string, unparsed
  • :after (String) — default: Date/Time string, unparsed
  • :today (Boolean)
  • :yesterday (Boolean)
  • :count (Number) — default: Number to return
  • :age (String) — default: 'old' or 'new'

#fork_editor(input = '', message: :default) ⇒ Object

Create a process for an editor and wait for the file handle to return

Parameters:

  • input (String) (defaults to: '') —

    Text input for editor

Raises:

  • (MissingEditor)

#format_input(input) ⇒ Array

Takes a multi-line string and formats it as an entry

Parameters:

  • input (String) —

    The string to parse

Returns:

  • (Array) —

    [[String]title, [Note]note]

Raises:

  • (EmptyInput)

#format_time(seconds, human: false) ⇒ Object

Format human readable time from seconds

Parameters:

  • seconds (Integer) —

    Seconds

#fuzzy_filter_items(items, opt: {}) ⇒ Object

#get_interval(item, formatted: true, record: true) ⇒ Object

Gets the interval between entry's start date and @done date

Parameters:

  • item (Item) —

    The entry

  • formatted (Boolean) (defaults to: true) —

    Return human readable time (default seconds)

  • record (Boolean) (defaults to: true) —

    Add the interval to the total for each tag

Returns:

  • Interval in seconds, or [d, h, m] array if formatted is true. False if no end date or interval is 0

#get_view(title) ⇒ Object

Gets a view from configuration

Parameters:

  • title (String) —

    The title of the view to retrieve

#guess_section(frag, guessed: false, suggest: false) ⇒ Object

Attempt to match a string with an existing section

Parameters:

  • frag (String) —

    The user-provided string

  • guessed (Boolean) (defaults to: false) —

    already guessed and failed

#guess_view(frag, guessed: false, suggest: false) ⇒ Object

Attempt to match a string with an existing view

Parameters:

  • frag (String) —

    The user-provided string

  • guessed (Boolean) (defaults to: false) —

    already guessed

#import(paths, opt = {}) ⇒ Object

Imports external entries

Parameters:

  • paths (String) —

    Path to JSON report file

  • opt (Hash) (defaults to: {}) —

    Additional Options

#init_doing_file(path = nil) ⇒ Object

Initializes the doing file.

Parameters:

  • path (String) (defaults to: nil) —

    Override path to a doing file, optional

#interactive(opt = {}) ⇒ Object

Display an interactive menu of entries

Options hash is shared with #filter_items and #act_on

Parameters:

  • opt (Hash) (defaults to: {}) —

    Additional options

Raises:

  • (NoResults)

#last(times: true, section: nil, options: {}) ⇒ Object

Show the last entry

Parameters:

  • times (Bool) (defaults to: true) —

    Show times

  • section (String) (defaults to: nil) —

    Section to pull from, default Currently

#last_entry(opt = {}) ⇒ Object

Get the last entry

Parameters:

  • opt (Hash) (defaults to: {}) —

    Additional Options

#last_note(section = 'All') ⇒ Object

Return the content of the last note for a given section

Parameters:

  • section (String) (defaults to: 'All') —

    The section to retrieve from, default All

Raises:

  • (NoEntryError)

#list_date(dates, section, times = nil, output = nil, opt = {}) ⇒ Object

Display entries within a date range

Parameters:

  • dates (Array) —

    [start, end]

  • section (String) —

    The section

  • times (Bool) (defaults to: nil) —

    Show times

  • output (String) (defaults to: nil) —

    Output format

  • opt (Hash) (defaults to: {}) —

    Additional Options

#list_section(opt = {}) ⇒ Object

Display contents of a section based on options

Parameters:

  • opt (Hash) (defaults to: {}) —

    Additional Options

#logger ⇒ Object

Logger

Responds to :debug, :info, :warn, and :error

Each method takes a topic, and a message or block

Example: debug('Hooks', 'Hook 1 triggered')

#next_item(item, options = {}) ⇒ Item

Get next item in the index

Parameters:

  • item (Item) —

    target item

  • options (Hash) (defaults to: {}) —

    additional options

Returns:

  • (Item) —

    the next chronological item in the index

See Also:

#recent(count = 10, section = nil, opt = {}) ⇒ Object

Show recent entries

Parameters:

  • count (Integer) (defaults to: 10) —

    The number to show

  • section (String) (defaults to: nil) —

    The section to show from, default Currently

  • opt (Hash) (defaults to: {}) —

    Additional Options

#repeat_item(item, opt = {}) ⇒ Object

Duplicate an item and add it as a new item

Parameters:

  • item (Item) —

    the item to duplicate

  • opt (Hash) (defaults to: {}) —

    additional options

Options Hash (opt):

  • :editor (Boolean) —

    open new item in editor

  • :date (String) —

    set start date

  • :in (String) —

    add new item to section :in

  • :note (Note) —

    add note to new item

Returns:

  • nothing

#repeat_last(opt = {}) ⇒ Object

Restart the last entry

Parameters:

  • opt (Hash) (defaults to: {}) —

    Additional Options

#reset_item(item, resume: false) ⇒ Object

Reset start date to current time, optionally remove done tag (resume)

Parameters:

  • item (Item) —

    the item to reset/resume

  • resume (Boolean) (defaults to: false) —

    removing @done tag if true

#restore_backup(file) ⇒ Object

Restore a backed up version of a file

Parameters:

  • file (String) —

    The filepath to restore

#rotate(opt = {}) ⇒ Object

Rename doing file with date and start fresh one

#sections ⇒ Array

List sections

Returns:

  • (Array) —

    section titles

#stop_start(target_tag, opt = {}) ⇒ Object

Accepts one tag and the raw text of a new item if the passed tag is on any item, it's replaced with @done. if new_item is not nil, it's tagged with the passed tag and inserted. This is for use where only one instance of a given tag should exist (@meanwhile)

Parameters:

  • target_tag (String) —

    Tag to replace

  • opt (Hash) (defaults to: {}) —

    Additional Options

Options Hash (opt):

  • :section (String) —

    target section

  • :archive (Boolean) —

    archive old item

  • :back (Date) —

    backdate new item

  • :new_item (String) —

    content to use for new item

  • :note (Array) —

    note content for new item

#tag_groups(items, opt: {}) ⇒ Object

#tag_last(opt = {}) ⇒ Object

Tag the last entry or X entries

Parameters:

  • opt (Hash) (defaults to: {}) —

    Additional Options (see

    filter_items for filtering

    options)

Raises:

  • (NoResults)

See Also:

#tag_times(format: :text, sort_by_name: false, sort_order: 'asc') ⇒ Object

Get total elapsed time for all tags in selection

Parameters:

  • format (String) (defaults to: :text) —

    return format (html, json, or text)

  • sort_by_name (Boolean) (defaults to: false) —

    Sort by name if true, otherwise by time

  • sort_order (String) (defaults to: 'asc') —

    The sort order (asc or desc)

#today(times = true, output = nil, opt = {}) ⇒ Object

Show all entries from the current day

Parameters:

  • times (Boolean) (defaults to: true) —

    show times

  • output (String) (defaults to: nil) —

    output format

  • opt (Hash) (defaults to: {}) —

    Options

#views ⇒ Array

List available views

Returns:

#write(file = nil, backup: true) ⇒ Object

Write content to file or STDOUT

Parameters:

  • file (String) (defaults to: nil) —

    The filepath to write to

#yesterday(section, times = nil, output = nil, opt = {}) ⇒ Object

Show entries from the previous day

Parameters:

  • section (String) —

    The section

  • times (Bool) (defaults to: nil) —

    Show times

  • output (String) (defaults to: nil) —

    Output format

  • opt (Hash) (defaults to: {}) —

    Additional Options