hledger-lib-1.2: Core data types, parsers and functionality for the hledger accounting tools

Safe Haskell | None
Language | Haskell2010

Hledger.Data.AccountName

Description

`AccountName`s are strings like `assets:cash:petty`, with multiple components separated by `:`. From a set of these we derive the account hierarchy.

Synopsis

- acctsepchar :: Char
- acctsep :: Text
- accountNameComponents :: AccountName -> [Text]
- accountNameFromComponents :: [Text] -> AccountName
- accountLeafName :: AccountName -> Text
- accountSummarisedName :: AccountName -> Text
- accountNameLevel :: AccountName -> Int
- accountNameDrop :: Int -> AccountName -> AccountName
- expandAccountNames :: [AccountName] -> [AccountName]
- expandAccountName :: AccountName -> [AccountName]
- topAccountNames :: [AccountName] -> [AccountName]
- parentAccountName :: AccountName -> AccountName
- parentAccountNames :: AccountName -> [AccountName]
- isAccountNamePrefixOf :: AccountName -> AccountName -> Bool
- isSubAccountNameOf :: AccountName -> AccountName -> Bool
- subAccountNamesFrom :: [AccountName] -> AccountName -> [AccountName]
- accountNameTreeFrom :: [AccountName] -> Tree AccountName
- nullaccountnametree :: IsString a => Tree a
- elideAccountName :: Int -> AccountName -> AccountName
- clipAccountName :: Int -> AccountName -> AccountName
- clipOrEllipsifyAccountName :: Int -> AccountName -> AccountName
- escapeName :: AccountName -> Regexp
- accountNameToAccountRegex :: AccountName -> Regexp
- accountNameToAccountOnlyRegex :: AccountName -> Regexp
- accountRegexToAccountName :: Regexp -> AccountName
- isAccountRegex :: String -> Bool
- tests_Hledger_Data_AccountName :: Test

# Documentation

acctsepchar :: Char Source #

acctsep :: Text Source #

accountNameComponents :: AccountName -> [Text] Source #

accountNameFromComponents :: [Text] -> AccountName Source #

accountLeafName :: AccountName -> Text Source #

accountSummarisedName :: AccountName -> Text Source #

Truncate all account name components but the last to two characters.

accountNameLevel :: AccountName -> Int Source #

accountNameDrop :: Int -> AccountName -> AccountName Source #

expandAccountNames :: [AccountName] -> [AccountName] Source #

"a:b:c","d:e"
  -> ["a","a:b","a:b:c","d","d:e"]

expandAccountName :: AccountName -> [AccountName] Source #

"a:b:c" -> ["a","a:b","a:b:c"]

topAccountNames :: [AccountName] -> [AccountName] Source #

"a:b:c","d:e"
  -> ["a","d"]

parentAccountName :: AccountName -> AccountName Source #

parentAccountNames :: AccountName -> [AccountName] Source #

isAccountNamePrefixOf :: AccountName -> AccountName -> Bool Source #

Is the first account a parent or other ancestor of (and not the same as) the second ?

isSubAccountNameOf :: AccountName -> AccountName -> Bool Source #

subAccountNamesFrom :: [AccountName] -> AccountName -> [AccountName] Source #

From a list of account names, select those which are direct subaccounts of the given account name.

accountNameTreeFrom :: [AccountName] -> Tree AccountName Source #

Convert a list of account names to a tree.

nullaccountnametree :: IsString a => Tree a Source #

elideAccountName :: Int -> AccountName -> AccountName Source #

Elide an account name to fit in the specified width. From the ledger 2.6 news:

      What Ledger now does is that if an account name is too long, it will
      start abbreviating the first parts of the account name down to two
      letters in length.  If this results in a string that is still too
      long, the front will be elided -- not the end.  For example:

        Expenses:Cash           ; OK, not too long
        Ex:Wednesday:Cash       ; Expenses was abbreviated to fit
        Ex:We:Afternoon:Cash    ; Expenses and Wednesday abbreviated
        ; Expenses:Wednesday:Afternoon:Lunch:Snack:Candy:Chocolate:Cash
        ..:Af:Lu:Sn:Ca:Ch:Cash  ; Abbreviated and elided!

clipAccountName :: Int -> AccountName -> AccountName Source #

Keep only the first n components of an account name, where n is a positive integer. If n is 0, returns the empty string.

clipOrEllipsifyAccountName :: Int -> AccountName -> AccountName Source #

Keep only the first n components of an account name, where n is a positive integer. If n is 0, returns "...".

escapeName :: AccountName -> Regexp Source #

Escape an AccountName for use within a regular expression. >>> putStr $ escapeName "First?!*? %)*!`#" First?!#$*?$(*) !`^

accountNameToAccountRegex :: AccountName -> Regexp Source #

Convert an account name to a regular expression matching it and its subaccounts.

accountNameToAccountOnlyRegex :: AccountName -> Regexp Source #

Convert an account name to a regular expression matching it but not its subaccounts.

accountRegexToAccountName :: Regexp -> AccountName Source #

Convert an exact account-matching regular expression to a plain account name.

isAccountRegex :: String -> Bool Source #

Does this string look like an exact account-matching regular expression ?

tests_Hledger_Data_AccountName :: Test Source #