str_methods.py File Reference

Add str methods to financial objects so that. More...

Go to the source code of this file.

Data Structures
class	str_methods.ClassWithCutting__format__

Functions
def	str_methods.setflag (self, name, value)
def	str_methods.getflag (self, name)
def	str_methods.register_optionflag (self, name)
def	str_methods.ya_add_method (_class, function, method_name=None, clsmethod=False, noinstance=False)
def	str_methods.infect (_class, function, method_name)
def	str_methods.all_as_classwithcutting__format__ (args)
def	str_methods.all_as_classwithcutting__format__keys (encoding=None, error=None, keys)
def	str_methods.__split__str__ (self, encoding=None, error=None)
def	str_methods.__transaction__str__ (self)
def	str_methods.__invoice__str__ (self)
def	str_methods.__entry__str__ (self)

Variables
string	str_methods.DEFAULT_ENCODING = "UTF-8"
string	str_methods.DEFAULT_ERROR = "ignore"

Detailed Description

Add str methods to financial objects so that.

print object 

leads to human readable results

Definition in file str_methods.py.

Function Documentation

__entry__str__()

def str_methods.__entry__str__

(

self

)

__str__ method for Entry

Definition at line 326 of file str_methods.py.

def __entry__str__(self):
    """__str__ method for Entry"""

    from gnucash.gnucash_business import Entry
    self=Entry(instance=self)

    # This dict and the return statement can be changed according to individual needs
    fmt_dict={
        "date_name":"Date:",
        "date_value":str(self.GetDate()),
        "description_name":"Description:",
        "description_value":self.GetDescription(),
        "notes_name":"Notes:",
        "notes_value":self.GetNotes(),
        "quant_name":"Quantity:",
        "quant_value":str(self.GetQuantity()),
        "invprice_name":"InvPrice:",
        "invprice_value":str(self.GetInvPrice())}

    return ("{date_name:6}{date_value:15} {description_name:13}{description_value:20} {notes_name:7}{notes_value:20}"+
            "{quant_name:12}{quant_value:7} {invprice_name:10}{invprice_value:7}").\
                format(**all_as_classwithcutting__format__keys(**fmt_dict))

__invoice__str__()

def str_methods.__invoice__str__

(

self

)

__str__ method for Invoice

Definition at line 286 of file str_methods.py.

def __invoice__str__(self):
    """__str__ method for Invoice"""

    from gnucash.gnucash_business import Invoice
    self=Invoice(instance=self)


    # This dict and the return statement can be changed according to individual needs
    fmt_dict={
        "id_name":"ID:",
        "id_value":self.GetID(),
        "notes_name":"Notes:",
        "notes_value":self.GetNotes(),
        "active_name":"Active:",
        "active_value":str(self.GetActive()),
        "owner_name":"Owner Name:",
        "owner_value":self.GetOwner().GetName(),
        "total_name":"Total:",
        "total_value":str(self.GetTotal()),
        "currency_mnemonic":self.GetCurrency().get_mnemonic()}

    ret_invoice= ("{id_name:4}{id_value:10} {notes_name:7}{notes_value:20} {active_name:8}{active_value:7} {owner_name:12}{owner_value:20}"+
                  "{total_name:8}{total_value:10}{currency_mnemonic:3}").\
                    format(**all_as_classwithcutting__format__keys(**fmt_dict))

    ret_entries=""
    entry_list = self.GetEntries()
    for entry in entry_list: # Type of entry has to be checked
      if not(type(entry)==Entry):
        entry=Entry(instance=entry)
      ret_entries += "  "+str(entry)+"\n"

    return ret_invoice+"\n"+ret_entries

__split__str__()

def str_methods.__split__str__	(		self,
			encoding = None,
			error = None
	)

__str__(self, encoding=None, error=None) -> object

Serialize the Split object and return as a new Unicode object.

Keyword arguments:
encoding -- defaults to str_methods.default_encoding
error -- defaults to str_methods.default_error
See help(unicode) for more details or http://docs.python.org/howto/unicode.html.

Definition at line 199 of file str_methods.py.

def __split__str__(self, encoding=None, error=None):
    """__str__(self, encoding=None, error=None) -> object

    Serialize the Split object and return as a new Unicode object.

    Keyword arguments:
    encoding -- defaults to str_methods.default_encoding
    error -- defaults to str_methods.default_error
    See help(unicode) for more details or http://docs.python.org/howto/unicode.html.

    """

    from gnucash import Split
    import time
    #self=Split(instance=self)

    lot=self.GetLot()
    if lot:
        if type(lot).__name__ == 'SwigPyObject':
          lot=gnucash.GncLot(instance=lot)
        lot_str=lot.get_title()
    else:
        lot_str='---'

    transaction=self.GetParent()

    # This dict and the return statement can be changed according to individual needs
    fmt_dict={
        "account":self.GetAccount().name,
        "value":self.GetValue(),
        "memo":self.GetMemo(),
        "lot":lot_str}

    fmt_str= ("Account: {account:20} "+
            "Value: {value:>10} "+
            "Memo: {memo:30} ")

    if self.optionflags & self.OPTIONFLAGS_BY_NAME["PRINT_TRANSACTION"]:
        fmt_t_dict={
            "transaction_time":time.ctime(transaction.GetDate()),
            "transaction2":transaction.GetDescription()}
        fmt_t_str=(
            "Transaction: {transaction_time:30} "+
            "- {transaction2:30} "+
            "Lot: {lot:10}")
        fmt_dict.update(fmt_t_dict)
        fmt_str += fmt_t_str

    return fmt_str.format(**all_as_classwithcutting__format__keys(encoding,error,**fmt_dict))

# This could be something like an __init__. Maybe we could call it virus because it infects the Split object which
# thereafter mutates to have better capabilities.
infect(gnucash.Split,__split__str__,"__str__")
gnucash.Split.register_optionflag("PRINT_TRANSACTION")
gnucash.Split.setflag("PRINT_TRANSACTION",True)

__transaction__str__()

def str_methods.__transaction__str__

(

self

)

__str__ method for Transaction class

Definition at line 255 of file str_methods.py.

def __transaction__str__(self):
    """__str__ method for Transaction class"""
    from gnucash import Transaction
    import time
    self=Transaction(instance=self)

    fmt_tuple=('Date:',time.ctime(self.GetDate()),
          'Description:',self.GetDescription(),
          'Notes:',self.GetNotes())

    transaction_str = "{0:6}{1:25} {2:14}{3:40} {4:7}{5:40}".format(
          *all_as_classwithcutting__format__(*fmt_tuple))
    transaction_str += "\n"

    splits_str=""
    for n,split in enumerate(self.GetSplitList()):
        if not (type(split)==gnucash.Split):
            split=gnucash.Split(instance=split)

        transaction_flag = split.getflag("PRINT_TRANSACTION")
        split.setflag("PRINT_TRANSACTION",False)
        splits_str += "[{0:>2}] ".format(str(n))
        splits_str += str(split)
        splits_str += "\n"
        split.setflag("PRINT_TRANSACTION",transaction_flag)

    return transaction_str + splits_str

gnucash.gnucash_core_c.__transaction__str__=__transaction__str__
gnucash.Transaction.add_method("__transaction__str__","__str__")

all_as_classwithcutting__format__()

def str_methods.all_as_classwithcutting__format__

(

args

)

Converts every argument to instance of ClassWithCutting__format__

Definition at line 168 of file str_methods.py.

def all_as_classwithcutting__format__(*args):
    """Converts every argument to instance of ClassWithCutting__format__"""

    #import types
    l=[]
    for a in args:
        #if type(a) in [types.StringType, types.UnicodeType]:
        #  a=a.decode("UTF-8")
        l.append(ClassWithCutting__format__(a))

    return l

all_as_classwithcutting__format__keys()

def str_methods.all_as_classwithcutting__format__keys	(		encoding = None,
			error = None,
			keys
	)

Converts every argument to instance of ClassWithCutting__format__

Definition at line 180 of file str_methods.py.

def all_as_classwithcutting__format__keys(encoding=None, error=None, **keys):
    """Converts every argument to instance of ClassWithCutting__format__"""

    #import types
    d={}
    if encoding==None:
      encoding=DEFAULT_ENCODING
    if error==None:
      error=DEFAULT_ERROR
    for a in keys:
        #if isinstance(keys[a], str):
        #  keys[a]=keys[a].decode(encoding,error)
        d[a]=ClassWithCutting__format__(keys[a])

    return d



# Split

register_optionflag()

def str_methods.register_optionflag	(		self,
			name
	)

Taken from doctest.py

Definition at line 53 of file str_methods.py.

def register_optionflag(self,name):
    """Taken from doctest.py"""
    # Create a new flag unless `name` is already known.
    return self.OPTIONFLAGS_BY_NAME.setdefault(name, 1 << len(self.OPTIONFLAGS_BY_NAME))

ya_add_method()

def str_methods.ya_add_method	(		_class,
			function,
			method_name = None,
			clsmethod = False,
			noinstance = False
	)

Calls add_method from function_methods.py but makes it
possible to use functions in this module. Also keeps the
docstring

Definition at line 58 of file str_methods.py.

def ya_add_method(_class, function, method_name=None, clsmethod=False, noinstance=False):
    """Calls add_method from function_methods.py but makes it
    possible to use functions in this module. Also keeps the
    docstring"""

    if method_name == None:
      method_name = function.__name__

    setattr(gnucash.gnucash_core_c,function.__name__,function)
    if clsmethod:
      mf=_class.ya_add_classmethod(function.__name__,method_name)
    elif noinstance:
      mf=_class.add_method(function.__name__,method_name)
    else:
      mf=_class.ya_add_method(function.__name__,method_name)
    if function.__doc__ != None:
      setattr(mf, "__doc__", function.__doc__)