Hledger.Cli.Add

A history-aware add command to help with data entry. |

Documentation

addmode :: Mode RawOpts

data EntryState

State used while entering transactions.

Constructors

EntryState

Fields

esOpts :: CliOpts

command line options

esArgs :: [String]

command line arguments remaining to be used as defaults

esToday :: Day

today's date

esDefDate :: Day

the default date for next transaction

esJournal :: Journal

the journal we are adding to

esSimilarTransaction :: Maybe Transaction

the most similar historical txn

esPostings :: [Posting]

postings entered so far in the current txn

Instances

Show EntryState

Typeable * EntryState

defEntryState :: EntryState

data RestartTransactionException

Constructors

RestartTransactionException

Instances

Show RestartTransactionException

Exception RestartTransactionException

Typeable * RestartTransactionException

add :: CliOpts -> Journal -> IO ()

Read multiple transactions from the console, prompting for each field, and append them to the journal file. If the journal came from stdin, this command has no effect.

showHelp :: IO ()

getAndAddTransactions :: EntryState -> IO ()

Loop reading transactions from the console, prompting, validating and appending each one to the journal file, until end of input or ctrl-c (then raise an EOF exception). If provided, command-line arguments are used as defaults; otherwise defaults come from the most similar recent transaction in the journal.

confirmedTransactionWizard :: EntryState -> Wizard Haskeline Transaction

transactionWizard :: EntryState -> Wizard Haskeline Transaction

similarTransaction :: EntryState -> String -> Maybe Transaction

dateAndCodeWizard :: EntryState -> Wizard Haskeline (Day, String)

descriptionAndCommentWizard :: EntryState -> Wizard Haskeline (String, String)

postingsWizard :: EntryState -> Wizard Haskeline [Posting]

postingWizard :: EntryState -> Wizard Haskeline (Maybe Posting)

postingsBalanced :: [Posting] -> Bool

accountWizard :: EntryState -> Wizard Haskeline [Char]

amountAndCommentWizard :: EntryState -> Wizard Haskeline (Amount, String)

maybeExit :: Wizard Haskeline [Char] -> Wizard Haskeline [Char]

maybeRestartTransaction :: Wizard Haskeline [Char] -> Wizard Haskeline [Char]

dateCompleter :: String -> CompletionFunc IO

descriptionCompleter :: Journal -> String -> CompletionFunc IO

accountCompleter :: Journal -> String -> CompletionFunc IO

amountCompleter :: String -> CompletionFunc IO

completer :: [String] -> String -> CompletionFunc IO

Generate a haskeline completion function from the given completions and default, that case insensitively completes with prefix matches, or infix matches above a minimum length, or completes the null string with the default.

defaultTo' :: b -> Wizard Haskeline b -> Wizard Haskeline b

withCompletion :: (:<:) WithSettings b => CompletionFunc IO -> Wizard b a -> Wizard b a

green :: [Char] -> [Char]

showDefault :: [Char] -> [Char]

journalAddTransaction :: Journal -> CliOpts -> Transaction -> IO Journal

Append this transaction to the journal's file and transaction list.

appendToJournalFileOrStdout :: FilePath -> String -> IO ()

Append a string, typically one or more transactions, to a journal file, or if the file is "-", dump it to stdout. Tries to avoid excess whitespace.

ensureOneNewlineTerminated :: String -> String

Replace a string's 0 or more terminating newlines with exactly one.

registerFromString :: String -> IO String

Convert a string of journal data into a register report.

capitalize :: String -> String

transactionsSimilarTo :: Journal -> Query -> String -> [(Double, Transaction)]

compareDescriptions :: [Char] -> [Char] -> Double

compareStrings :: String -> String -> Double

Return a similarity measure, from 0 to 1, for two strings. This is Simon White's letter pairs algorithm from http:/www.catalysoft.comarticles/StrikeAMatch.html with a modification for short strings.

wordLetterPairs :: String -> [[Char]]

letterPairs :: [t] -> [[t]]