#ifndef _JOURNAL_H #define _JOURNAL_H #include "xpath.h" #include "util.h" namespace ledger { // These flags persist with the object #define TRANSACTION_NORMAL 0x0000 #define TRANSACTION_VIRTUAL 0x0001 #define TRANSACTION_BALANCE 0x0002 #define TRANSACTION_AUTO 0x0004 #define TRANSACTION_BULK_ALLOC 0x0008 #define TRANSACTION_CALCULATED 0x0010 class entry_t; class account_t; class transaction_t { public: enum state_t { UNCLEARED, CLEARED, PENDING }; entry_t * entry; moment_t _date; moment_t _date_eff; account_t * account; amount_t amount; string amount_expr; amount_t * cost; string cost_expr; state_t state; unsigned short flags; string note; unsigned long beg_pos; unsigned long beg_line; unsigned long end_pos; unsigned long end_line; mutable void * data; static bool use_effective_date; transaction_t(account_t * _account = NULL) : entry(NULL), account(_account), cost(NULL), state(UNCLEARED), flags(TRANSACTION_NORMAL), beg_pos(0), beg_line(0), end_pos(0), end_line(0), data(NULL) { TRACE_CTOR(transaction_t, "account_t *"); } transaction_t(account_t * _account, const amount_t& _amount, unsigned int _flags = TRANSACTION_NORMAL, const string& _note = "") : entry(NULL), account(_account), amount(_amount), cost(NULL), state(UNCLEARED), flags(_flags), note(_note), beg_pos(0), beg_line(0), end_pos(0), end_line(0), data(NULL) { TRACE_CTOR(transaction_t, "account_t *, const amount_t&, unsigned int, const string&"); } transaction_t(const transaction_t& xact) : entry(xact.entry), account(xact.account), amount(xact.amount), cost(xact.cost ? new amount_t(*xact.cost) : NULL), state(xact.state), flags(xact.flags), note(xact.note), beg_pos(0), beg_line(0), end_pos(0), end_line(0), data(NULL) { TRACE_CTOR(transaction_t, "copy"); } ~transaction_t(); moment_t actual_date() const; moment_t effective_date() const; moment_t date() const { if (use_effective_date) return effective_date(); else return actual_date(); } bool operator==(const transaction_t& xact) { return this == &xact; } bool operator!=(const transaction_t& xact) { return ! (*this == xact); } bool valid() const; }; class xact_context : public file_context { public: const transaction_t& xact; xact_context(const transaction_t& _xact, const string& desc = "") throw(); virtual ~xact_context() throw() {} }; class journal_t; typedef std::list transactions_list; class entry_base_t { public: journal_t * journal; unsigned long src_idx; unsigned long beg_pos; unsigned long beg_line; unsigned long end_pos; unsigned long end_line; transactions_list transactions; entry_base_t() : journal(NULL), beg_pos(0), beg_line(0), end_pos(0), end_line(0) { TRACE_CTOR(entry_base_t, ""); } entry_base_t(const entry_base_t& e) : journal(NULL), beg_pos(0), beg_line(0), end_pos(0), end_line(0) { TRACE_CTOR(entry_base_t, "copy"); for (transactions_list::const_iterator i = e.transactions.begin(); i != e.transactions.end(); i++) transactions.push_back(new transaction_t(**i)); } virtual ~entry_base_t() { TRACE_DTOR(entry_base_t); for (transactions_list::iterator i = transactions.begin(); i != transactions.end(); i++) if (! ((*i)->flags & TRANSACTION_BULK_ALLOC)) delete *i; else (*i)->~transaction_t(); } bool operator==(const entry_base_t& entry) { return this == &entry; } bool operator!=(const entry_base_t& entry) { return ! (*this == entry); } virtual void add_transaction(transaction_t * xact); virtual bool remove_transaction(transaction_t * xact); virtual bool finalize(); virtual bool valid() const = 0; }; class entry_t : public entry_base_t { public: moment_t _date; moment_t _date_eff; string code; string payee; mutable void * data; entry_t() : data(NULL) { TRACE_CTOR(entry_t, ""); } entry_t(const entry_t& e); virtual ~entry_t() { TRACE_DTOR(entry_t); } moment_t actual_date() const { return _date; } moment_t effective_date() const { if (! is_valid_moment(_date_eff)) return _date; return _date_eff; } moment_t date() const { if (transaction_t::use_effective_date) return effective_date(); else return actual_date(); } virtual void add_transaction(transaction_t * xact); virtual bool valid() const; bool get_state(transaction_t::state_t * state) const; }; struct entry_finalizer_t { virtual ~entry_finalizer_t() {} virtual bool operator()(entry_t& entry, bool post) = 0; }; void print_entry(std::ostream& out, const entry_base_t& entry, const string& prefix = ""); class entry_context : public error_context { public: const entry_base_t& entry; entry_context(const entry_base_t& _entry, const string& _desc = "") throw() : error_context(_desc), entry(_entry) {} virtual ~entry_context() throw() {} virtual void describe(std::ostream& out) const throw(); }; class balance_error : public error { public: balance_error(const string& _reason, error_context * _ctxt = NULL) throw() : error(_reason, _ctxt) {} virtual ~balance_error() throw() {} }; class auto_entry_t : public entry_base_t { public: xml::xpath_t predicate; auto_entry_t() { TRACE_CTOR(auto_entry_t, ""); } auto_entry_t(const string& _predicate) : predicate(_predicate) { TRACE_CTOR(auto_entry_t, "const string&"); } virtual ~auto_entry_t() { TRACE_DTOR(auto_entry_t); } virtual void extend_entry(entry_base_t& entry, bool post); virtual bool valid() const { return true; } }; struct auto_entry_finalizer_t : public entry_finalizer_t { journal_t * journal; auto_entry_finalizer_t(journal_t * _journal) : journal(_journal) {} virtual bool operator()(entry_t& entry, bool post); }; class period_entry_t : public entry_base_t { public: interval_t period; string period_string; period_entry_t() { TRACE_CTOR(period_entry_t, ""); } period_entry_t(const string& _period) : period(_period), period_string(_period) { TRACE_CTOR(period_entry_t, "const string&"); } period_entry_t(const period_entry_t& e) : entry_base_t(e), period(e.period), period_string(e.period_string) { TRACE_CTOR(period_entry_t, "copy"); } virtual ~period_entry_t() { TRACE_DTOR(period_entry_t); } virtual bool valid() const { return period; } }; typedef std::map accounts_map; typedef std::pair accounts_pair; class account_t { public: typedef unsigned long ident_t; journal_t * journal; account_t * parent; string name; string note; unsigned short depth; accounts_map accounts; mutable void * data; mutable ident_t ident; mutable string _fullname; account_t(account_t * _parent = NULL, const string& _name = "", const string& _note = "") : parent(_parent), name(_name), note(_note), depth(parent ? parent->depth + 1 : 0), data(NULL), ident(0) { TRACE_CTOR(account_t, "account_t *, const string&, const string&"); } ~account_t(); bool operator==(const account_t& account) { return this == &account; } bool operator!=(const account_t& account) { return ! (*this == account); } string fullname() const; void add_account(account_t * acct) { accounts.insert(accounts_pair(acct->name, acct)); acct->journal = journal; } bool remove_account(account_t * acct) { accounts_map::size_type n = accounts.erase(acct->name); acct->journal = NULL; return n > 0; } account_t * find_account(const string& name, bool auto_create = true); operator string() const { return fullname(); } bool valid() const; friend class journal_t; }; std::ostream& operator<<(std::ostream& out, const account_t& account); struct func_finalizer_t : public entry_finalizer_t { typedef bool (*func_t)(entry_t& entry, bool post); func_t func; func_finalizer_t(func_t _func) : func(_func) {} func_finalizer_t(const func_finalizer_t& other) : entry_finalizer_t(), func(other.func) {} virtual bool operator()(entry_t& entry, bool post) { return func(entry, post); } }; template void add_hook(std::list& list, T obj, const bool prepend = false) { if (prepend) list.push_front(obj); else list.push_back(obj); } template void remove_hook(std::list& list, T obj) { list.remove(obj); } template bool run_hooks(std::list& list, Data& item, bool post) { for (typename std::list::const_iterator i = list.begin(); i != list.end(); i++) if (! (*(*i))(item, post)) return false; return true; } typedef std::list entries_list; typedef std::list auto_entries_list; typedef std::list period_entries_list; typedef std::list strings_list; class session_t; class journal_t { public: session_t * session; account_t * master; account_t * basket; entries_list entries; strings_list sources; string price_db; char * item_pool; char * item_pool_end; // This is used for dynamically representing the journal data as an // XML tree, to facilitate transformations without modifying any of // the underlying structures (the transformers modify the XML tree // -- perhaps even adding, changing or deleting nodes -- but they do // not affect the basic data parsed from the journal file). xml::document_t * document; auto_entries_list auto_entries; period_entries_list period_entries; mutable accounts_map accounts_cache; std::list entry_finalize_hooks; journal_t(session_t * _session) : session(_session), basket(NULL), item_pool(NULL), item_pool_end(NULL), document(NULL) { TRACE_CTOR(journal_t, ""); master = new account_t(NULL, ""); master->journal = this; } ~journal_t(); bool operator==(const journal_t& journal) { return this == &journal; } bool operator!=(const journal_t& journal) { return ! (*this == journal); } void add_account(account_t * acct) { master->add_account(acct); acct->journal = this; } bool remove_account(account_t * acct) { return master->remove_account(acct); acct->journal = NULL; } account_t * find_account(const string& name, bool auto_create = true) { accounts_map::iterator c = accounts_cache.find(name); if (c != accounts_cache.end()) return (*c).second; account_t * account = master->find_account(name, auto_create); accounts_cache.insert(accounts_pair(name, account)); account->journal = this; return account; } account_t * find_account_re(const string& regexp); bool add_entry(entry_t * entry); bool remove_entry(entry_t * entry); void add_entry_finalizer(entry_finalizer_t * finalizer) { add_hook(entry_finalize_hooks, finalizer); } void remove_entry_finalizer(entry_finalizer_t * finalizer) { remove_hook(entry_finalize_hooks, finalizer); } bool valid() const; }; inline void extend_entry_base(journal_t * journal, entry_base_t& entry, bool post) { for (auto_entries_list::iterator i = journal->auto_entries.begin(); i != journal->auto_entries.end(); i++) (*i)->extend_entry(entry, post); } inline bool auto_entry_finalizer_t::operator()(entry_t& entry, bool post) { extend_entry_base(journal, entry, post); return true; } extern const string version; } // namespace ledger #endif // _JOURNAL_H