gnc_convenience.py File Reference

some functions to make life easier when using python-bindings More...

Go to the source code of this file.

Functions
	gnc_convenience.get_transaction_list (account)
	gnc_convenience.get_splits_without_lot (account=None, split_list=None)
	gnc_convenience.find_account (account, name, account_list=None)
	gnc_convenience.find_lot (lot_list, search_string)
	gnc_convenience.find_split (split_list, search_string)
	gnc_convenience.find_split_recursive (account, search_string)
	gnc_convenience.find_transaction (account, name, ignore_case=True, transaction_list=None)

Detailed Description

some functions to make life easier when using python-bindings

Author

Christoph Holtermann (c.hol.nosp@m.term.nosp@m.ann@g.nosp@m.mx.d.nosp@m.e)

Date

May 2011

Definition in file gnc_convenience.py.

Function Documentation

find_account()

gnc_convenience.find_account	(		account,
			name,
			account_list = None
	)

Recursively searches full names of account and descendents

returns a list of accounts which contain name.

options:

account:      account to start search in.
name:         name to search for.
account_list: (optional) list to append accounts to.

Definition at line 59 of file gnc_convenience.py.

def find_account(account,name,account_list=None):
  """Recursively searches full names of account and descendents
 
  returns a list of accounts which contain name.
  
  options:
  
  account:      account to start search in.
  name:         name to search for.
  account_list: (optional) list to append accounts to.
  
  """
 
  if not account_list:
    account_list=[]
 
  for child in account.get_children():
    account_list=find_account(child,name,account_list)
  
  account_name=account.GetName()
  if name in account_name:
    account_list.append(account)
  
  return account_list
 
 

find_lot()

gnc_convenience.find_lot	(		lot_list,
			search_string
	)

Searches lots in lot_list for search_string.

returns list of lots where title contains search_string.

options:

lot_list:       List of Lots to search in.
search_string:  String to search for.

Definition at line 85 of file gnc_convenience.py.

def find_lot(lot_list,search_string):
  """Searches lots in lot_list for search_string.
 
  returns list of lots where title contains search_string.
 
  options:
 
  lot_list:       List of Lots to search in.
  search_string:  String to search for.
  
  """
  
  rlist=[]
  for lot in lot_list:
    ltitle=lot.get_title()
    if search_string in ltitle: 
      rlist.append(lot)
  return rlist
 
 

find_split()

gnc_convenience.find_split	(		split_list,
			search_string
	)

Searches a list of splits for search_string

returns a list of splits that have search_string as part of
memo or
description of parent transaction.

options:

split_list:     List of Splits to search in.
search_string:  String to search for.

Definition at line 105 of file gnc_convenience.py.

def find_split(split_list,search_string):
  """Searches a list of splits for search_string
  
  returns a list of splits that have search_string as part of
  memo or
  description of parent transaction.
  
  options:
 
  split_list:     List of Splits to search in.
  search_string:  String to search for.
  
  """
  
  rlist=[]
  for split in split_list:
      memo=split.GetMemo()
      transaction_description=split.GetParent().GetDescription()
      if (search_string in memo) or (search_string in transaction_description):
          rlist.append(split)
  return rlist
 
 

find_split_recursive()

gnc_convenience.find_split_recursive	(		account,
			search_string
	)

Searches account and descendants for Splits containing search_string

returns a list of splits that have search_string as part of
memo or
description of parent transaction.

options:

account:        Account to search in.
search_string:  String to search for.

Definition at line 128 of file gnc_convenience.py.

def find_split_recursive(account, search_string):
  """Searches account and descendants for Splits containing search_string
  
  returns a list of splits that have search_string as part of
  memo or
  description of parent transaction.
  
  options:
 
  account:        Account to search in.
  search_string:  String to search for.
  
  """
  
  rlist = []
  child_account_splits = []
  
  # Get all splits in descendants
  for child in account.get_children():
      childsplits = find_split_recursive(child, search_string)
      child_account_splits += childsplits
 
  # Get all splits in account
  splits=account.GetSplitList()
  basic_account_splits=find_split(splits,search_string)
 
  rlist=child_account_splits+basic_account_splits
  return rlist
 
 

find_transaction()

gnc_convenience.find_transaction	(		account,
			name,
			ignore_case = True,
			transaction_list = None
	)

Searches the transactions of an account for name.

Searches in description and in memo of each split.
returns a list of transactions that match criteria.

options:

account:          Account to search in.
name:             String to search for.
ignore_case:      (optional, default=True) Ignore case if True.
transaction_list: (optional) list of transactions to search in.

Definition at line 158 of file gnc_convenience.py.

def find_transaction(account,name,ignore_case=True,transaction_list=None):
  """Searches the transactions of an account for name.
  
  Searches in description and in memo of each split.
  returns a list of transactions that match criteria.
  
  options:
  
  account:          Account to search in.
  name:             String to search for.
  ignore_case:      (optional, default=True) Ignore case if True.
  transaction_list: (optional) list of transactions to search in.
  
  """
 
  if not transaction_list:
      transaction_list=get_transaction_list(account)
 
  ret = []
  if ignore_case:
      name=name.lower()
 
  for transaction in transaction_list:
      found = False
      
      desc=transaction.GetDescription()
      if ignore_case:
          desc=desc.lower()
      
      if name in desc:
          found=True
      
      sl=transaction.GetSplitList()
      for split in sl:
          memo = split.GetMemo()
          if ignore_case:
              memo=memo.lower()
 
          if name in memo:
              found=True
 
      if found:
          ret.append(transaction)
 
  return ret

get_splits_without_lot()

gnc_convenience.get_splits_without_lot	(		account = None,
			split_list = None
	)

Returns a list of those Splits in split_list or account which do not have an according lot.

options:

account:      (optional) Account to search in.
split_list:   (optional) List of Splits to search in.

one or the other has to be provided.

Definition at line 34 of file gnc_convenience.py.

def get_splits_without_lot(account=None,split_list=None):
  """Returns a list of those Splits in split_list or account which do not have an according lot.
 
  options:
 
  account:      (optional) Account to search in.
  split_list:   (optional) List of Splits to search in.
 
  one or the other has to be provided.
 
  """
  if split_list==None:
      if account==None:
          return []
      else:
          split_list=account.GetSplitList()
  
  rlist=[]
  for split in split_list:
      lot=split.GetLot()
      if lot == None:
          rlist.append(split)
  return rlist
 
 

get_transaction_list()

gnc_convenience.get_transaction_list

(

account

)

Returns all transactions in account.

Splits are derived from account.GetSplitList().

options:

account:    Account to get transactions from.

Definition at line 14 of file gnc_convenience.py.

def get_transaction_list(account):
    """Returns all transactions in account.
 
    Splits are derived from account.GetSplitList().
   
    options:
 
    account:    Account to get transactions from.
    
    """
    
    split_list=account.GetSplitList()
    transaction_list=[]
    for split in split_list:
        transaction=split.GetParent()
        if not (transaction in transaction_list):       # this check may not be necessary.
          transaction_list.append(transaction)
    return transaction_list