diff --git a/doc/build/html/.buildinfo b/doc/build/html/.buildinfo new file mode 100644 index 0000000..ead248e --- /dev/null +++ b/doc/build/html/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: b1e0a7a37d51c2c1ffe67d5d69a96004 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/doc/build/html/_modules/accounting.html b/doc/build/html/_modules/accounting.html new file mode 100644 index 0000000..4b7754e --- /dev/null +++ b/doc/build/html/_modules/accounting.html @@ -0,0 +1,412 @@ + + + + + + + + accounting — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting

+import sys
+import subprocess
+import logging
+import time
+
+from datetime import datetime
+from xml.etree import ElementTree
+from contextlib import contextmanager
+
+from accounting.models import Account, Transaction, Posting, Amount
+
+_log = logging.getLogger(__name__)
+
+
[docs]class Ledger: + def __init__(self, ledger_file=None, ledger_bin=None): + if ledger_file is None: + raise ValueError('ledger_file cannot be None') + + self.ledger_bin = ledger_bin or 'ledger' + self.ledger_file = ledger_file + _log.info('ledger file: %s', ledger_file) + + self.locked = False + self.ledger_process = None + + @contextmanager +
[docs] def locked_process(self): + r''' + Context manager that checks that the ledger process is not already + locked, then "locks" the process and yields the process handle and + unlocks the process when execution is returned. + + Since this decorated as a :func:`contextlib.contextmanager` the + recommended use is with the ``with``-statement. + + .. code-block:: python + + with self.locked_process() as p: + p.stdin.write(b'bal\n') + + output = self.read_until_prompt(p) + + ''' + if self.locked: + raise RuntimeError('The process has already been locked,' + ' something\'s out of order.') + + # XXX: This code has no purpose in a single-threaded process + timeout = 5 # Seconds + + for i in range(1, timeout + 2): + if i > timeout: + raise RuntimeError('Ledger process is already locked') + + if not self.locked: + break + else: + _log.info('Waiting for one second... %d/%d', i, timeout) + time.sleep(1) + + process = self.get_process() + + self.locked = True + _log.debug('Lock enabled') + + yield process + + self.locked = False + _log.debug('Lock disabled') +
+
[docs] def assemble_arguments(self): + ''' + Returns a list of arguments suitable for :class:`subprocess.Popen` based on + :attr:`self.ledger_bin` and :attr:`self.ledger_file`. + ''' + return [ + self.ledger_bin, + '-f', + self.ledger_file, + ] +
+
[docs] def init_process(self): + ''' + Creates a new (presumably) ledger subprocess based on the args from + :meth:`Ledger.assemble_arguments()` and then runs + :meth:`Ledger.read_until_prompt()` once (which should return the banner + text) and discards the output. + ''' + _log.debug('Starting ledger process...') + self.ledger_process = subprocess.Popen( + self.assemble_arguments(), + stdout=subprocess.PIPE, + stdin=subprocess.PIPE, + stderr=subprocess.PIPE) + + # Swallow the banner + with self.locked_process() as p: + self.read_until_prompt(p) + + return self.ledger_process +
+
[docs] def get_process(self): + ''' + Returns :attr:`self.ledger_process` if it evaluates to ``True``. If + :attr:`self.ledger_process` is not set the result of + :meth:`self.init_process() <Ledger.init_process>` is returned. + ''' + return self.ledger_process or self.init_process() +
+
[docs] def read_until_prompt(self, process): + r''' + Reads from the subprocess instance :data:`process` until it finds a + combination of ``\n]\x20`` (the prompt), then returns the output + without the prompt. + ''' + output = b'' + + while True: + line = process.stdout.read(1) # XXX: This is a hack + + output += line + + if b'\n] ' in output: + _log.debug('Found prompt!') + break + + output = output[:-3] # Cut away the prompt + + _log.debug('output: %s', output) + + return output +
+
[docs] def send_command(self, command): + output = None + + with self.locked_process() as p: + if isinstance(command, str): + command = command.encode('utf8') + + p.stdin.write(command + b'\n') + p.stdin.flush() + + output = self.read_until_prompt(p) + + self.ledger_process.send_signal(subprocess.signal.SIGTERM) + _log.debug('Waiting for ledger to shut down') + self.ledger_process.wait() + self.ledger_process = None + + return output +
+
[docs] def add_transaction(self, transaction): + ''' + Writes a transaction to the ledger file by opening it in 'ab' mode and + writing a ledger transaction based on the + :class:`~accounting.models.Transaction` instance in :data:`transaction`. + ''' + if not transaction.metadata.get('Id'): + transaction.generate_id() + + transaction_template = ('\n{date} {t.payee}\n' + '{tags}' + '{postings}') + + metadata_template = ' ;{0}: {1}\n' + + # TODO: Generate metadata for postings + posting_template = (' {account} {p.amount.symbol}' + ' {p.amount.amount}\n') + + output = b'' + + # XXX: Even I hardly understands what this does, however I indent it it + # stays unreadable. + output += transaction_template.format( + date=transaction.date.strftime('%Y-%m-%d'), + t=transaction, + tags=''.join([ + metadata_template.format(k, v) \ + for k, v in transaction.metadata.items()]), + postings=''.join([posting_template.format( + p=p, + account=p.account + ' ' * ( + 80 - (len(p.account) + len(p.amount.symbol) + + len(str(p.amount.amount)) + 1 + 2) + )) for p in transaction.postings + ]) + ).encode('utf8') + + with open(self.ledger_file, 'ab') as f: + f.write(output) + + _log.debug('written to file: %s', output) +
+
[docs] def bal(self): + output = self.send_command('xml') + + if output is None: + raise RuntimeError('bal call returned no output') + + accounts = [] + + xml = ElementTree.fromstring(output.decode('utf8')) + + accounts = self._recurse_accounts(xml.find('./accounts')) + + return accounts +
+ def _recurse_accounts(self, root): + accounts = [] + + for account in root.findall('./account'): + name = account.find('./fullname').text + + amounts = [] + + # Try to find an account total value, then try to find the account + # balance + account_amounts = account.findall( + './account-total/balance/amount') or \ + account.findall('./account-amount/amount') or \ + account.findall('./account-total/amount') + + if account_amounts: + for amount in account_amounts: + quantity = amount.find('./quantity').text + symbol = amount.find('./commodity/symbol').text + + amounts.append(Amount(amount=quantity, symbol=symbol)) + else: + _log.warning('Account %s does not have any amounts', name) + + accounts.append(Account(name=name, + amounts=amounts, + accounts=self._recurse_accounts(account))) + + return accounts + +
[docs] def reg(self): + output = self.send_command('xml') + + if output is None: + raise RuntimeError('reg call returned no output') + + entries = [] + + reg_xml = ElementTree.fromstring(output.decode('utf8')) + + for transaction in reg_xml.findall('./transactions/transaction'): + date = datetime.strptime(transaction.find('./date').text, + '%Y/%m/%d') + payee = transaction.find('./payee').text + + postings = [] + + for posting in transaction.findall('./postings/posting'): + account = posting.find('./account/name').text + amount = posting.find('./post-amount/amount/quantity').text + symbol = posting.find( + './post-amount/amount/commodity/symbol').text + + # Get the posting metadata + metadata = {} + + values = posting.findall('./metadata/value') + if values: + for value in values: + key = value.get('key') + value = value.find('./string').text + + _log.debug('metadata: %s: %s', key, value) + + metadata.update({key: value}) + + postings.append( + Posting(account=account, + metadata=metadata, + amount=Amount(amount=amount, symbol=symbol))) + + # Get the transaction metadata + metadata = {} + + values = transaction.findall('./metadata/value') + if values: + for value in values: + key = value.get('key') + value = value.find('./string').text + + _log.debug('metadata: %s: %s', key, value) + + metadata.update({key: value}) + + # Add a Transaction instance to the list + entries.append( + Transaction(date=date, payee=payee, postings=postings, + metadata=metadata)) + + return entries + +
+
[docs]def main(argv=None): + import argparse + if argv is None: + argv = sys.argv + + parser = argparse.ArgumentParser() + parser.add_argument('-v', '--verbosity', + default='INFO', + help=('Filter logging output. Possible values:' + + ' CRITICAL, ERROR, WARNING, INFO, DEBUG')) + + args = parser.parse_args(argv[1:]) + logging.basicConfig(level=getattr(logging, args.verbosity, 'INFO')) + ledger = Ledger(ledger_file='non-profit-test-data.ledger') + print(ledger.bal()) + print(ledger.reg()) + +
+if __name__ == '__main__': + sys.exit(main()) +
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/client.html b/doc/build/html/_modules/accounting/client.html new file mode 100644 index 0000000..8688152 --- /dev/null +++ b/doc/build/html/_modules/accounting/client.html @@ -0,0 +1,225 @@ + + + + + + + + accounting.client — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.client

+import sys
+import argparse
+import json
+import logging
+
+from datetime import datetime
+from decimal import Decimal
+
+import requests
+
+from accounting.models import Transaction, Posting, Amount
+from accounting.transport import AccountingDecoder, AccountingEncoder
+
+_log = logging.getLogger(__name__)
+
+
+
[docs]class Client: + def __init__(self, host=None, json_encoder=None, + json_decoder=None): + self.host = host or 'http://localhost:5000' + self.json_encoder = json_encoder or AccountingEncoder + self.json_decoder = json_decoder or AccountingDecoder + +
[docs] def get_balance(self): + balance = self.get('/balance') + return balance['balance_report'] +
+
[docs] def get(self, path): + response = requests.get(self.host + path) + + return self._decode_response(response) +
+ def _decode_response(self, response): + response_data = response.json(cls=self.json_decoder) + + _log.debug('response_data: %s', response_data) + + return response_data + +
[docs] def post(self, path, payload, **kw): + kw.update({'headers': {'Content-Type': 'application/json'}}) + kw.update({'data': json.dumps(payload, cls=self.json_encoder)}) + + return self._decode_response(requests.post(self.host + path, **kw)) +
+
[docs] def simple_transaction(self, from_acc, to_acc, amount): + t = Transaction( + date=datetime.today(), + payee='PayPal donation', + postings=[ + Posting(account=from_acc, + amount=Amount(symbol='$', amount=-amount)), + Posting(account=to_acc, + amount=Amount(symbol='$', amount=amount)) + ] + ) + + return self.post('/transaction', {'transactions': [t]}) +
+
[docs] def get_register(self): + register = self.get('/register') + + return register['register_report'] + +
+ + +
[docs]def main(argv=None, prog=None): + global HOST + if argv is None: + prog = sys.argv[0] + argv = sys.argv[1:] + + parser = argparse.ArgumentParser(prog=prog) + actions = parser.add_subparsers(title='Actions', dest='action') + + insert = actions.add_parser('insert', + aliases=['in']) + insert.add_argument('from_account') + insert.add_argument('to_account') + insert.add_argument('amount', type=Decimal) + + balance = actions.add_parser('balance', aliases=['bal']) + + register = actions.add_parser('register', aliases=['reg']) + + parser.add_argument('-v', '--verbosity', + default='WARNING', + help=('Filter logging output. Possible values:' + + ' CRITICAL, ERROR, WARNING, INFO, DEBUG')) + parser.add_argument('--host', default='http://localhost:5000') + + args = parser.parse_args(argv) + + logging.basicConfig(level=getattr(logging, args.verbosity)) + + client = Client(args.host) + + if args.action in ['insert', 'in']: + print(client.simple_transaction(args.from_account, args.to_account, + args.amount)) + elif args.action in ['balance', 'bal']: + print_balance_accounts(client.get_balance()) + elif args.action in ['register', 'reg']: + print_transactions(client.get_register()) + else: + parser.print_help() +
+if __name__ == '__main__': + sys.exit(main()) +
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/decorators.html b/doc/build/html/_modules/accounting/decorators.html new file mode 100644 index 0000000..ffe701b --- /dev/null +++ b/doc/build/html/_modules/accounting/decorators.html @@ -0,0 +1,114 @@ + + + + + + + + accounting.decorators — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.decorators

+from functools import wraps
+
+from flask import jsonify
+
+from accounting.exceptions import AccountingException
+
+
+
[docs]def jsonify_exceptions(func): + ''' + Wraps a Flask endpoint and catches any AccountingException-based + exceptions which are returned to the client as JSON. + ''' + @wraps(func) + def wrapper(*args, **kw): + try: + return func(*args, **kw) + except AccountingException as exc: + return jsonify(error=exc) + + return wrapper
+
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/exceptions.html b/doc/build/html/_modules/accounting/exceptions.html new file mode 100644 index 0000000..6e7a3f3 --- /dev/null +++ b/doc/build/html/_modules/accounting/exceptions.html @@ -0,0 +1,100 @@ + + + + + + + + accounting.exceptions — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.exceptions

+
[docs]class AccountingException(Exception): + ''' + Used as a base for exceptions that are returned to the caller via the + jsonify_exceptions decorator + ''' + pass
+
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/gtkclient.html b/doc/build/html/_modules/accounting/gtkclient.html new file mode 100644 index 0000000..da65a3f --- /dev/null +++ b/doc/build/html/_modules/accounting/gtkclient.html @@ -0,0 +1,241 @@ + + + + + + + + accounting.gtkclient — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.gtkclient

+import sys
+import logging
+import threading
+import pkg_resources
+
+from functools import wraps
+from datetime import datetime
+
+from gi.repository import Gtk
+from gi.repository import GLib
+from gi.repository import GObject
+
+from accounting.client import Client
+
+_log = logging.getLogger(__name__)
+
+
+
[docs]def indicate_activity(func_or_str): + description = None + + def decorator(func): + @wraps(func) + def wrapper(self, *args, **kw): + self.status_description.set_text(description) + self.activity_indicator.show() + self.activity_indicator.start() + + return func(self, *args, **kw) + + return wrapper + + if callable(func_or_str): + description = 'Working' + return decorator(func_or_str) + else: + description = func_or_str + return decorator + +
+
[docs]def indicate_activity_done(func): + @wraps(func) + def wrapper(self, *args, **kw): + self.status_description.set_text('') + self.activity_indicator.stop() + self.activity_indicator.hide() + + return func(self, *args, **kw) + + return wrapper + +
+
[docs]class AccountingApplication: + def __init__(self): + #Gtk.Window.__init__(self, title='Accounting Client') + + self.client = Client() + + self.load_ui(pkg_resources.resource_filename( + 'accounting', 'res/client-ui.glade')) + + self.aboutdialog.set_transient_for(self.accounting_window) + + self.accounting_window.connect('delete-event', Gtk.main_quit) + self.accounting_window.set_border_width(0) + self.accounting_window.set_default_geometry(640, 360) + + self.accounting_window.show_all() + +
[docs] def load_ui(self, path): + _log.debug('Loading UI...') + builder = Gtk.Builder() + builder.add_from_file(path) + builder.connect_signals(self) + + for element in builder.get_objects(): + _log.debug('Loaded %s', Gtk.Buildable.get_name(element)) + setattr(self, Gtk.Buildable.get_name(element), element) + + _log.debug('UI loaded') +
+
[docs] def on_transaction_selected(self, widget): + selection = self.transaction_view.get_selection() + selection.set_mode(Gtk.SelectionMode.SINGLE) + xact_store, xact_iter = selection.get_selected() + + xact_id = xact_store.get_value(xact_iter, 0) + _log.debug('selection: %s', xact_id) + + for transaction in self.transaction_data: + if transaction.id == xact_id: + self.lbl_payee.set_text(transaction.payee) + + self.posting_store.clear() + + for posting in transaction.postings: + self.posting_store.append([ + posting.account, + str(posting.amount.amount), + posting.amount.symbol + ]) + + self.detail_view.show() + break +
+
[docs] def on_show_about_activate(self, widget): + _log.debug('Showing About') + self.aboutdialog.show_all() +
+
[docs] def on_aboutdialog_close(self, widget): + _log.debug('Closing About') + self.aboutdialog.hide_all() +
+ @indicate_activity('Refreshing Transactions') +
[docs] def on_refresh_transactions_activate(self, widget): + def load_transactions(): + transactions = self.client.get_register() + GLib.idle_add(self.on_transactions_loaded, transactions) + + threading.Thread(target=load_transactions).start() +
+ @indicate_activity_done +
[docs] def on_transactions_loaded(self, transactions): + _log.debug('transactions: %s', transactions) + + self.transaction_data = transactions + self.transaction_store.clear() + + for transaction in transactions: + self.transaction_store.append([ + transaction.id, + transaction.date.strftime('%Y-%m-%d'), + transaction.payee + ]) + +
+
[docs]def main(argv=None): + logging.basicConfig(level=logging.DEBUG) + + GObject.threads_init() + + accounting = AccountingApplication() + #accounting_win.connect('delete-event', Gtk.main_quit) + + Gtk.main() +
+if __name__ == '__main__': + sys.exit(main()) +
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/models.html b/doc/build/html/_modules/accounting/models.html new file mode 100644 index 0000000..ac25d19 --- /dev/null +++ b/doc/build/html/_modules/accounting/models.html @@ -0,0 +1,149 @@ + + + + + + + + accounting.models — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.models

+import uuid
+from decimal import Decimal
+
+
+
[docs]class Transaction: + def __init__(self, date=None, payee=None, postings=None, metadata=None, + _generate_id=False): + self.date = date + self.payee = payee + self.postings = postings + self.metadata = metadata if metadata is not None else {} + + if _generate_id: + self.generate_id() + +
[docs] def generate_id(self): + self.metadata.update({'Id': uuid.uuid4()}) +
+ def __repr__(self): + return ('<{self.__class__.__name__} {date}' + + ' {self.payee} {self.postings}').format( + self=self, + date=self.date.strftime('%Y-%m-%d')) + +
+
[docs]class Posting: + def __init__(self, account=None, amount=None, metadata=None): + self.account = account + self.amount = amount + self.metadata = metadata if metadata is not None else {} + + def __repr__(self): + return ('<{self.__class__.__name__} "{self.account}"' + + ' {self.amount}>').format(self=self) + +
+
[docs]class Amount: + def __init__(self, amount=None, symbol=None): + self.amount = Decimal(amount) + self.symbol = symbol + + def __repr__(self): + return ('<{self.__class__.__name__} {self.symbol}' + + ' {self.amount}>').format(self=self) + +
+
[docs]class Account: + def __init__(self, name=None, amounts=None, accounts=None): + self.name = name + self.amounts = amounts + self.accounts = accounts + + def __repr__(self): + return ('<{self.__class__.__name__} "{self.name}" {self.amounts}' + + ' {self.accounts}>').format(self=self)
+
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/storage.html b/doc/build/html/_modules/accounting/storage.html new file mode 100644 index 0000000..8ef62a2 --- /dev/null +++ b/doc/build/html/_modules/accounting/storage.html @@ -0,0 +1,112 @@ + + + + + + + + accounting.storage — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.storage

+class Storage:
+
[docs] ''' + ABC for accounting storage + ''' + def __init__(self, *args, **kw): + raise NotImplementedError() + + def get_transactions(self, *args, **kw): +
[docs] raise NotImplementedError() + + def get_transaction(self, *args, **kw):
+
[docs] raise NotImplementedError() + + def get_account(self, *args, **kw):
+
[docs] raise NotImplementedError() + + def get_accounts(self, *args, **kw):
+
[docs] raise NotImplementedError() +
+ +
+
+ +
+
+ + +
+
+
+ + + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/storage/ledgercli.html b/doc/build/html/_modules/accounting/storage/ledgercli.html new file mode 100644 index 0000000..c32fbcf --- /dev/null +++ b/doc/build/html/_modules/accounting/storage/ledgercli.html @@ -0,0 +1,429 @@ + + + + + + + + accounting.storage.ledgercli — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.storage.ledgercli

+import sys
+import subprocess
+import logging
+import time
+
+from datetime import datetime
+from xml.etree import ElementTree
+from contextlib import contextmanager
+
+from accounting.models import Account, Transaction, Posting, Amount
+from accounting.storage import Storage
+
+_log = logging.getLogger(__name__)
+
+
+
[docs]class Ledger(Storage): + def __init__(self, app=None, ledger_file=None, ledger_bin=None): + if app: + ledger_file = app.config['LEDGER_FILE'] + + if ledger_file is None: + raise ValueError('ledger_file cannot be None') + + self.ledger_bin = ledger_bin or 'ledger' + self.ledger_file = ledger_file + _log.info('ledger file: %s', ledger_file) + + self.locked = False + self.ledger_process = None + + @contextmanager +
[docs] def locked_process(self): + r''' + Context manager that checks that the ledger process is not already + locked, then "locks" the process and yields the process handle and + unlocks the process when execution is returned. + + Since this decorated as a :func:`contextlib.contextmanager` the + recommended use is with the ``with``-statement. + + .. code-block:: python + + with self.locked_process() as p: + p.stdin.write(b'bal\n') + + output = self.read_until_prompt(p) + + ''' + if self.locked: + raise RuntimeError('The process has already been locked,' + ' something\'s out of order.') + + # XXX: This code has no purpose in a single-threaded process + timeout = 5 # Seconds + + for i in range(1, timeout + 2): + if i > timeout: + raise RuntimeError('Ledger process is already locked') + + if not self.locked: + break + else: + _log.info('Waiting for one second... %d/%d', i, timeout) + time.sleep(1) + + process = self.get_process() + + self.locked = True + _log.debug('Lock enabled') + + yield process + + self.locked = False + _log.debug('Lock disabled') +
+
[docs] def assemble_arguments(self): + ''' + Returns a list of arguments suitable for :class:`subprocess.Popen` + based on :attr:`self.ledger_bin` and :attr:`self.ledger_file`. + ''' + return [ + self.ledger_bin, + '-f', + self.ledger_file, + ] +
+
[docs] def init_process(self): + ''' + Creates a new (presumably) ledger subprocess based on the args from + :meth:`Ledger.assemble_arguments()` and then runs + :meth:`Ledger.read_until_prompt()` once (which should return the banner + text) and discards the output. + ''' + _log.debug('Starting ledger process...') + self.ledger_process = subprocess.Popen( + self.assemble_arguments(), + stdout=subprocess.PIPE, + stdin=subprocess.PIPE, + stderr=subprocess.PIPE) + + # Swallow the banner + with self.locked_process() as p: + self.read_until_prompt(p) + + return self.ledger_process +
+
[docs] def get_process(self): + ''' + Returns :attr:`self.ledger_process` if it evaluates to ``True``. If + :attr:`self.ledger_process` is not set the result of + :meth:`self.init_process() <Ledger.init_process>` is returned. + ''' + return self.ledger_process or self.init_process() +
+
[docs] def read_until_prompt(self, process): + r''' + Reads from the subprocess instance :data:`process` until it finds a + combination of ``\n]\x20`` (the prompt), then returns the output + without the prompt. + ''' + output = b'' + + while True: + line = process.stdout.read(1) # XXX: This is a hack + + output += line + + if b'\n] ' in output: + _log.debug('Found prompt!') + break + + output = output[:-3] # Cut away the prompt + + _log.debug('output: %s', output) + + return output +
+
[docs] def send_command(self, command): + output = None + + with self.locked_process() as p: + if isinstance(command, str): + command = command.encode('utf8') + + p.stdin.write(command + b'\n') + p.stdin.flush() + + output = self.read_until_prompt(p) + + self.ledger_process.send_signal(subprocess.signal.SIGTERM) + _log.debug('Waiting for ledger to shut down') + self.ledger_process.wait() + self.ledger_process = None + + return output +
+
[docs] def add_transaction(self, transaction): + ''' + Writes a transaction to the ledger file by opening it in 'ab' mode and + writing a ledger transaction based on the + :class:`~accounting.models.Transaction` instance in + :data:`transaction`. + ''' + if not transaction.metadata.get('Id'): + transaction.generate_id() + + transaction_template = ('\n{date} {t.payee}\n' + '{tags}' + '{postings}') + + metadata_template = ' ;{0}: {1}\n' + + # TODO: Generate metadata for postings + posting_template = (' {account} {p.amount.symbol}' + ' {p.amount.amount}\n') + + output = b'' + + # XXX: Even I hardly understands what this does, however I indent it it + # stays unreadable. + output += transaction_template.format( + date=transaction.date.strftime('%Y-%m-%d'), + t=transaction, + tags=''.join([ + metadata_template.format(k, v) + for k, v in transaction.metadata.items()]), + postings=''.join([posting_template.format( + p=p, + account=p.account + ' ' * ( + 80 - (len(p.account) + len(p.amount.symbol) + + len(str(p.amount.amount)) + 1 + 2) + )) for p in transaction.postings + ]) + ).encode('utf8') + + with open(self.ledger_file, 'ab') as f: + f.write(output) + + _log.debug('written to file: %s', output) +
+
[docs] def bal(self): + output = self.send_command('xml') + + if output is None: + raise RuntimeError('bal call returned no output') + + accounts = [] + + xml = ElementTree.fromstring(output.decode('utf8')) + + accounts = self._recurse_accounts(xml.find('./accounts')) + + return accounts +
+ def _recurse_accounts(self, root): + accounts = [] + + for account in root.findall('./account'): + name = account.find('./fullname').text + + amounts = [] + + # Try to find an account total value, then try to find the account + # balance + account_amounts = account.findall( + './account-total/balance/amount') or \ + account.findall('./account-amount/amount') or \ + account.findall('./account-total/amount') + + if account_amounts: + for amount in account_amounts: + quantity = amount.find('./quantity').text + symbol = amount.find('./commodity/symbol').text + + amounts.append(Amount(amount=quantity, symbol=symbol)) + else: + _log.warning('Account %s does not have any amounts', name) + + accounts.append(Account(name=name, + amounts=amounts, + accounts=self._recurse_accounts(account))) + + return accounts + +
[docs] def get_transactions(self): + return self.reg() +
+
[docs] def reg(self): + output = self.send_command('xml') + + if output is None: + raise RuntimeError('reg call returned no output') + + entries = [] + + reg_xml = ElementTree.fromstring(output.decode('utf8')) + + for transaction in reg_xml.findall('./transactions/transaction'): + date = datetime.strptime(transaction.find('./date').text, + '%Y/%m/%d') + payee = transaction.find('./payee').text + + postings = [] + + for posting in transaction.findall('./postings/posting'): + account = posting.find('./account/name').text + amount = posting.find('./post-amount/amount/quantity').text + symbol = posting.find( + './post-amount/amount/commodity/symbol').text + + # Get the posting metadata + metadata = {} + + values = posting.findall('./metadata/value') + if values: + for value in values: + key = value.get('key') + value = value.find('./string').text + + _log.debug('metadata: %s: %s', key, value) + + metadata.update({key: value}) + + postings.append( + Posting(account=account, + metadata=metadata, + amount=Amount(amount=amount, symbol=symbol))) + + # Get the transaction metadata + metadata = {} + + values = transaction.findall('./metadata/value') + if values: + for value in values: + key = value.get('key') + value = value.find('./string').text + + _log.debug('metadata: %s: %s', key, value) + + metadata.update({key: value}) + + # Add a Transaction instance to the list + id = metadata.pop('Id') + entries.append( + Transaction(id=id, date=date, payee=payee, postings=postings, + metadata=metadata)) + + return entries +
+
[docs] def update_transaction(self, transaction): + _log.debug('DUMMY: Updated transaction: %s', transaction) + +
+
[docs]def main(argv=None): + import argparse + if argv is None: + argv = sys.argv + + parser = argparse.ArgumentParser() + parser.add_argument('-v', '--verbosity', + default='INFO', + help=('Filter logging output. Possible values:' + + ' CRITICAL, ERROR, WARNING, INFO, DEBUG')) + + args = parser.parse_args(argv[1:]) + logging.basicConfig(level=getattr(logging, args.verbosity, 'INFO')) + ledger = Ledger(ledger_file='non-profit-test-data.ledger') + print(ledger.bal()) + print(ledger.reg()) + +
+if __name__ == '__main__': + sys.exit(main()) +
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/storage/sql.html b/doc/build/html/_modules/accounting/storage/sql.html new file mode 100644 index 0000000..b769f58 --- /dev/null +++ b/doc/build/html/_modules/accounting/storage/sql.html @@ -0,0 +1,180 @@ + + + + + + + + accounting.storage.sql — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.storage.sql

+import logging
+import json
+
+from flask.ext.sqlalchemy import SQLAlchemy
+
+from accounting.exceptions import AccountingException
+from accounting.storage import Storage
+from accounting.models import Transaction, Posting, Amount
+
+_log = logging.getLogger(__name__)
+db = None
+
+
+
[docs]class SQLStorage(Storage): + def __init__(self, app=None): + global db + + if not app: + raise Exception('Missing app keyword argument') + + self.app = app + db = self.db = SQLAlchemy(app) + + from .models import Transaction as SQLTransaction, \ + Posting as SQLPosting, Amount as SQLAmount + + db.create_all() + + self.Transaction = SQLTransaction + self.Posting = SQLPosting + self.Amount = SQLAmount + +
[docs] def get_transactions(self, *args, **kw): + transactions = [] + + for transaction in self.Transaction.query.all(): + dict_transaction = transaction.as_dict() + dict_postings = dict_transaction.pop('postings') + + postings = [] + + for dict_posting in dict_postings: + dict_amount = dict_posting.pop('amount') + posting = Posting(**dict_posting) + posting.amount = Amount(**dict_amount) + + postings.append(posting) + + dict_transaction.update({'postings': postings}) + + transactions.append(Transaction(**dict_transaction)) + + return transactions +
+
[docs] def update_transaction(self, transaction): + if transaction.id is None: + raise AccountingException('The transaction id must be set for' + ' update_transaction calls') + + _log.debug('DUMMY: Update transaction: %s', transaction) +
+
[docs] def add_transaction(self, transaction): + if transaction.id is None: + transaction.generate_id() + + _t = self.Transaction() + _t.uuid = transaction.id + _t.date = transaction.date + _t.payee = transaction.payee + _t.meta = json.dumps(transaction.metadata) + + self.db.session.add(_t) + + for posting in transaction.postings: + _p = self.Posting() + _p.transaction_uuid = transaction.id + _p.account = posting.account + _p.meta = json.dumps(posting.metadata) + _p.amount = self.Amount(symbol=posting.amount.symbol, + amount=posting.amount.amount) + + self.db.session.add(_p) + + self.db.session.commit()
+
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/storage/sql/models.html b/doc/build/html/_modules/accounting/storage/sql/models.html new file mode 100644 index 0000000..b07dced --- /dev/null +++ b/doc/build/html/_modules/accounting/storage/sql/models.html @@ -0,0 +1,151 @@ + + + + + + + + accounting.storage.sql.models — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.storage.sql.models

+import json
+
+from . import db
+
+
+
[docs]class Transaction(db.Model): + id = db.Column(db.Integer(), primary_key=True) + uuid = db.Column(db.String, unique=True, nullable=False) + date = db.Column(db.DateTime) + payee = db.Column(db.String()) + meta = db.Column(db.String()) + +
[docs] def as_dict(self): + return dict( + id=self.uuid, + date=self.date, + payee=self.payee, + postings=[p.as_dict() for p in self.postings], + metadata=json.loads(self.meta) + ) + +
+
[docs]class Posting(db.Model): + id = db.Column(db.Integer(), primary_key=True) + + transaction_uuid = db.Column(db.String, db.ForeignKey('transaction.uuid')) + transaction = db.relationship('Transaction', backref='postings') + + account = db.Column(db.String, nullable=False) + + amount_id = db.Column(db.Integer, db.ForeignKey('amount.id')) + amount = db.relationship('Amount') + + meta = db.Column(db.String) + +
[docs] def as_dict(self): + return dict( + account=self.account, + amount=self.amount.as_dict(), + metadata=json.loads(self.meta) + ) + +
+
[docs]class Amount(db.Model): + id = db.Column(db.Integer, primary_key=True) + symbol = db.Column(db.String) + amount = db.Column(db.Numeric) + +
[docs] def as_dict(self): + return dict( + symbol=self.symbol, + amount=self.amount + )
+
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/transport.html b/doc/build/html/_modules/accounting/transport.html new file mode 100644 index 0000000..566751f --- /dev/null +++ b/doc/build/html/_modules/accounting/transport.html @@ -0,0 +1,155 @@ + + + + + + + + accounting.transport — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.transport

+from datetime import datetime
+
+from flask import json
+
+from accounting.models import Amount, Transaction, Posting, Account
+
+
[docs]class AccountingEncoder(json.JSONEncoder): +
[docs] def default(self, o): + if isinstance(o, Account): + return dict( + __type__=o.__class__.__name__, + name=o.name, + amounts=o.amounts, + accounts=o.accounts + ) + elif isinstance(o, Transaction): + return dict( + __type__=o.__class__.__name__, + date=o.date.strftime('%Y-%m-%d'), + payee=o.payee, + postings=o.postings, + metadata=o.metadata + ) + elif isinstance(o, Posting): + return dict( + __type__=o.__class__.__name__, + account=o.account, + amount=o.amount, + metadata=o.metadata + ) + elif isinstance(o, Amount): + return dict( + __type__=o.__class__.__name__, + amount=str(o.amount), + symbol=o.symbol + ) + elif isinstance(o, Exception): + return dict( + __type__=o.__class__.__name__, + args=o.args + ) + + return json.JSONEncoder.default(self, o) +
+
[docs]class AccountingDecoder(json.JSONDecoder): + def __init__(self): + json.JSONDecoder.__init__(self, object_hook=self.dict_to_object) + +
[docs] def dict_to_object(self, d): + if '__type__' not in d: + return d + + types = {c.__name__ : c for c in [Amount, Transaction, Posting, + Account]} + + _type = d.pop('__type__') + + if _type == 'Transaction': + d['date'] = datetime.strptime(d['date'], '%Y-%m-%d') + + return types[_type](**d)
+
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/accounting/web.html b/doc/build/html/_modules/accounting/web.html new file mode 100644 index 0000000..f73456c --- /dev/null +++ b/doc/build/html/_modules/accounting/web.html @@ -0,0 +1,292 @@ + + + + + + + + accounting.web — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
+
+
+
+ +

Source code for accounting.web

+'''
+This module contains the high-level webservice logic such as the Flask setup
+and the Flask endpoints.
+'''
+import sys
+import logging
+import argparse
+
+from flask import Flask, jsonify, request
+
+from accounting import Ledger
+from accounting.transport import AccountingEncoder, AccountingDecoder
+from accounting.exceptions import AccountingException
+from accounting.decorators import jsonify_exceptions
+
+
+app = Flask('accounting')
+app.config.from_pyfile('config.py')
+
+ledger = None
+
+@app.before_request
+
[docs]def init_ledger(): + ''' + :py:meth:`flask.Flask.before_request`-decorated method that initializes an + :py:class:`accounting.Ledger` object. + ''' + global ledger + ledger = Ledger(ledger_file=app.config['LEDGER_FILE']) + + +# These will convert output from our internal classes to JSON and back
+app.json_encoder = AccountingEncoder +app.json_decoder = AccountingDecoder + + +@app.route('/') +
[docs]def index(): + ''' Hello World! ''' + return 'Hello World!' + +
+@app.route('/balance') +
[docs]def balance_report(): + ''' + Returns the JSON-serialized result of :meth:`accounting.Ledger.bal` + ''' + report_data = ledger.bal() + + return jsonify(balance_report=report_data) +
+@app.route('/transaction', methods=['GET']) +
[docs]def transaction_get(): + ''' + Returns the JSON-serialized output of :meth:`accounting.Ledger.reg` + ''' + return jsonify(transactions=ledger.reg()) +
+@app.route('/transaction', methods=['POST']) +@jsonify_exceptions +
[docs]def transaction_post(): + ''' + REST/JSON endpoint for transactions. + + Current state: + + Takes a POST request with a ``transactions`` JSON payload and writes it to + the ledger file. + + Requires the ``transactions`` payload to be __type__-annotated: + + .. code-block:: json + + { + "transactions": [ + { + "__type__": "Transaction", + "date": "2013-01-01", + "payee": "Kindly T. Donor", + "postings": [ + { + "__type__": "Posting", + "account": "Income:Foo:Donation", + "amount": { + "__type__": "Amount", + "amount": "-100", + "symbol": "$" + } + }, + { + "__type__": "Posting", + "account": "Assets:Checking", + "amount": { + "__type__": "Amount", + "amount": "100", + "symbol": "$" + } + } + ] + } + } + + becomes:: + + 2013-01-01 Kindly T. Donor + Income:Foo:Donation $ -100 + Assets:Checking $ 100 + ''' + transactions = request.json.get('transactions') + + if not transactions: + raise AccountingException('No transaction data provided') + + for transaction in transactions: + ledger.add_transaction(transaction) + + return jsonify(foo='bar') + +
+@app.route('/parse-json', methods=['POST']) +
[docs]def parse_json(): + r''' + Parses a __type__-annotated JSON payload and debug-logs the decoded version + of it. + + Example: + + .. code-block:: bash + + wget http://127.0.0.1:5000/balance -O balance.json + curl -X POST -H 'Content-Type: application/json' -d @balance.json \ + http://127.0.0.1/parse-json + # Logging output (linebreaks added for clarity) + # DEBUG:accounting:json data: {'balance_report': + # [<Account "None" [ + # <Amount $ 0>, <Amount KARMA 0>] + # [<Account "Assets" [ + # <Amount $ 50>, <Amount KARMA 10>] + # [<Account "Assets:Checking" [ + # <Amount $ 50>] []>, + # <Account "Assets:Karma Account" [ + # <Amount KARMA 10>] []>]>, + # <Account "Expenses" [ + # <Amount $ 500>] + # [<Account "Expenses:Blah" [ + # <Amount $ 250>] + # [<Account "Expenses:Blah:Hosting" [ + # <Amount $ 250>] []>]>, + # <Account "Expenses:Foo" [ + # <Amount $ 250>] [ + # <Account "Expenses:Foo:Hosting" [ + # <Amount $ 250>] []>]>]>, + # <Account "Income" [ + # <Amount $ -550>, + # <Amount KARMA -10>] + # [<Account "Income:Donation" [ + # <Amount $ -50>] []>, + # <Account "Income:Foo" [ + # <Amount $ -500>] + # [<Account "Income:Foo:Donation" [ + # <Amount $ -500>] []>]>, + # <Account "Income:Karma" [ + # <Amount KARMA -10>] []>]>]>]} + ''' + app.logger.debug('json data: %s', request.json) + return jsonify(foo='bar') + +
+@app.route('/register') +
[docs]def register_report(): + ''' + Returns the JSON-serialized output of :py:meth:`accounting.Ledger.reg` + ''' + report_data = ledger.reg() + + return jsonify(register_report=report_data) + +
+
[docs]def main(argv=None): + prog = __name__ + if argv is None: + prog = sys.argv[0] + argv = sys.argv[1:] + + parser = argparse.ArgumentParser(prog=prog) + parser.add_argument('-v', '--verbosity', + default='INFO', + help=('Filter logging output. Possible values:' + + ' CRITICAL, ERROR, WARNING, INFO, DEBUG')) + + args = parser.parse_args(argv) + + logging.basicConfig(level=getattr(logging, args.verbosity, 'INFO')) + + app.run(host=app.config['HOST'], port=app.config['PORT']) +
+if __name__ == '__main__': + main() +
+ +
+
+
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_modules/index.html b/doc/build/html/_modules/index.html new file mode 100644 index 0000000..3f427b4 --- /dev/null +++ b/doc/build/html/_modules/index.html @@ -0,0 +1,101 @@ + + + + + + + + Overview: module code — Accounting API 0.1-beta documentation + + + + + + + + + + + + + +
+
+ +
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/build/html/_sources/api/accounting.storage.sql.txt b/doc/build/html/_sources/api/accounting.storage.sql.txt new file mode 100644 index 0000000..b0b3b9f --- /dev/null +++ b/doc/build/html/_sources/api/accounting.storage.sql.txt @@ -0,0 +1,22 @@ +accounting.storage.sql package +============================== + +Submodules +---------- + +accounting.storage.sql.models module +------------------------------------ + +.. automodule:: accounting.storage.sql.models + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: accounting.storage.sql + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/build/html/_sources/api/accounting.storage.txt b/doc/build/html/_sources/api/accounting.storage.txt new file mode 100644 index 0000000..3cabead --- /dev/null +++ b/doc/build/html/_sources/api/accounting.storage.txt @@ -0,0 +1,29 @@ +accounting.storage package +========================== + +Subpackages +----------- + +.. toctree:: + + accounting.storage.sql + +Submodules +---------- + +accounting.storage.ledgercli module +----------------------------------- + +.. automodule:: accounting.storage.ledgercli + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: accounting.storage + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/build/html/_sources/api/accounting.txt b/doc/build/html/_sources/api/accounting.txt new file mode 100644 index 0000000..91469dd --- /dev/null +++ b/doc/build/html/_sources/api/accounting.txt @@ -0,0 +1,85 @@ +accounting package +================== + +Subpackages +----------- + +.. toctree:: + + accounting.storage + +Submodules +---------- + +accounting.client module +------------------------ + +.. automodule:: accounting.client + :members: + :undoc-members: + :show-inheritance: + +accounting.config module +------------------------ + +.. automodule:: accounting.config + :members: + :undoc-members: + :show-inheritance: + +accounting.decorators module +---------------------------- + +.. automodule:: accounting.decorators + :members: + :undoc-members: + :show-inheritance: + +accounting.exceptions module +---------------------------- + +.. automodule:: accounting.exceptions + :members: + :undoc-members: + :show-inheritance: + +accounting.gtkclient module +--------------------------- + +.. automodule:: accounting.gtkclient + :members: + :undoc-members: + :show-inheritance: + +accounting.models module +------------------------ + +.. automodule:: accounting.models + :members: + :undoc-members: + :show-inheritance: + +accounting.transport module +--------------------------- + +.. automodule:: accounting.transport + :members: + :undoc-members: + :show-inheritance: + +accounting.web module +--------------------- + +.. automodule:: accounting.web + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: accounting + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/build/html/_sources/api/asyncio-test.txt b/doc/build/html/_sources/api/asyncio-test.txt new file mode 100644 index 0000000..ccf6b97 --- /dev/null +++ b/doc/build/html/_sources/api/asyncio-test.txt @@ -0,0 +1,7 @@ +asyncio-test Module +=================== + +.. automodule:: asyncio-test + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/build/html/_sources/api/modules.txt b/doc/build/html/_sources/api/modules.txt new file mode 100644 index 0000000..a52165b --- /dev/null +++ b/doc/build/html/_sources/api/modules.txt @@ -0,0 +1,7 @@ +accounting +========== + +.. toctree:: + :maxdepth: 4 + + accounting diff --git a/doc/build/html/_sources/index.txt b/doc/build/html/_sources/index.txt new file mode 100644 index 0000000..20a2b93 --- /dev/null +++ b/doc/build/html/_sources/index.txt @@ -0,0 +1,23 @@ +.. Accounting API documentation master file, created by + sphinx-quickstart on Thu Dec 12 14:02:01 2013. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to Accounting API's documentation! +========================================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + api/accounting.rst + + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` diff --git a/doc/build/html/_static/ajax-loader.gif b/doc/build/html/_static/ajax-loader.gif new file mode 100644 index 0000000..61faf8c Binary files /dev/null and b/doc/build/html/_static/ajax-loader.gif differ diff --git a/doc/build/html/_static/basic.css b/doc/build/html/_static/basic.css new file mode 100644 index 0000000..d8e0346 --- /dev/null +++ b/doc/build/html/_static/basic.css @@ -0,0 +1,536 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox input[type="text"] { + width: 170px; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + width: 30px; +} + +img { + border: 0; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable dl, table.indextable dd { + margin-top: 0; + margin-bottom: 0; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- general body styles --------------------------------------------------- */ + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.field-list ul { + padding-left: 1em; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.field-list td, table.field-list th { + border: 0 !important; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, .highlighted { + background-color: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.optional { + font-size: 1.3em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +tt.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +tt.descclassname { + background-color: transparent; +} + +tt.xref, a tt { + background-color: transparent; + font-weight: bold; +} + +h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/doc/build/html/_static/comment-bright.png b/doc/build/html/_static/comment-bright.png new file mode 100644 index 0000000..551517b Binary files /dev/null and b/doc/build/html/_static/comment-bright.png differ diff --git a/doc/build/html/_static/comment-close.png b/doc/build/html/_static/comment-close.png new file mode 100644 index 0000000..09b54be Binary files /dev/null and b/doc/build/html/_static/comment-close.png differ diff --git a/doc/build/html/_static/comment.png b/doc/build/html/_static/comment.png new file mode 100644 index 0000000..92feb52 Binary files /dev/null and b/doc/build/html/_static/comment.png differ diff --git a/doc/build/html/_static/default.css b/doc/build/html/_static/default.css new file mode 100644 index 0000000..e534a07 --- /dev/null +++ b/doc/build/html/_static/default.css @@ -0,0 +1,256 @@ +/* + * default.css_t + * ~~~~~~~~~~~~~ + * + * Sphinx stylesheet -- default theme. + * + * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +@import url("basic.css"); + +/* -- page layout ----------------------------------------------------------- */ + +body { + font-family: sans-serif; + font-size: 100%; + background-color: #11303d; + color: #000; + margin: 0; + padding: 0; +} + +div.document { + background-color: #1c4e63; +} + +div.documentwrapper { + float: left; + width: 100%; +} + +div.bodywrapper { + margin: 0 0 0 230px; +} + +div.body { + background-color: #ffffff; + color: #000000; + padding: 0 20px 30px 20px; +} + +div.footer { + color: #ffffff; + width: 100%; + padding: 9px 0 9px 0; + text-align: center; + font-size: 75%; +} + +div.footer a { + color: #ffffff; + text-decoration: underline; +} + +div.related { + background-color: #133f52; + line-height: 30px; + color: #ffffff; +} + +div.related a { + color: #ffffff; +} + +div.sphinxsidebar { +} + +div.sphinxsidebar h3 { + font-family: 'Trebuchet MS', sans-serif; + color: #ffffff; + font-size: 1.4em; + font-weight: normal; + margin: 0; + padding: 0; +} + +div.sphinxsidebar h3 a { + color: #ffffff; +} + +div.sphinxsidebar h4 { + font-family: 'Trebuchet MS', sans-serif; + color: #ffffff; + font-size: 1.3em; + font-weight: normal; + margin: 5px 0 0 0; + padding: 0; +} + +div.sphinxsidebar p { + color: #ffffff; +} + +div.sphinxsidebar p.topless { + margin: 5px 10px 10px 10px; +} + +div.sphinxsidebar ul { + margin: 10px; + padding: 0; + color: #ffffff; +} + +div.sphinxsidebar a { + color: #98dbcc; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + + + +/* -- hyperlink styles ------------------------------------------------------ */ + +a { + color: #355f7c; + text-decoration: none; +} + +a:visited { + color: #355f7c; + text-decoration: none; +} + +a:hover { + text-decoration: underline; +} + + + +/* -- body styles ----------------------------------------------------------- */ + +div.body h1, +div.body h2, +div.body h3, +div.body h4, +div.body h5, +div.body h6 { + font-family: 'Trebuchet MS', sans-serif; + background-color: #f2f2f2; + font-weight: normal; + color: #20435c; + border-bottom: 1px solid #ccc; + margin: 20px -20px 10px -20px; + padding: 3px 0 3px 10px; +} + +div.body h1 { margin-top: 0; font-size: 200%; } +div.body h2 { font-size: 160%; } +div.body h3 { font-size: 140%; } +div.body h4 { font-size: 120%; } +div.body h5 { font-size: 110%; } +div.body h6 { font-size: 100%; } + +a.headerlink { + color: #c60f0f; + font-size: 0.8em; + padding: 0 4px 0 4px; + text-decoration: none; +} + +a.headerlink:hover { + background-color: #c60f0f; + color: white; +} + +div.body p, div.body dd, div.body li { + text-align: justify; + line-height: 130%; +} + +div.admonition p.admonition-title + p { + display: inline; +} + +div.admonition p { + margin-bottom: 5px; +} + +div.admonition pre { + margin-bottom: 5px; +} + +div.admonition ul, div.admonition ol { + margin-bottom: 5px; +} + +div.note { + background-color: #eee; + border: 1px solid #ccc; +} + +div.seealso { + background-color: #ffc; + border: 1px solid #ff6; +} + +div.topic { + background-color: #eee; +} + +div.warning { + background-color: #ffe4e4; + border: 1px solid #f66; +} + +p.admonition-title { + display: inline; +} + +p.admonition-title:after { + content: ":"; +} + +pre { + padding: 5px; + background-color: #eeffcc; + color: #333333; + line-height: 120%; + border: 1px solid #ac9; + border-left: none; + border-right: none; +} + +tt { + background-color: #ecf0f3; + padding: 0 1px 0 1px; + font-size: 0.95em; +} + +th { + background-color: #ede; +} + +.warning tt { + background: #efc2c2; +} + +.note tt { + background: #d6d6d6; +} + +.viewcode-back { + font-family: sans-serif; +} + +div.viewcode-block:target { + background-color: #f4debf; + border-top: 1px solid #ac9; + border-bottom: 1px solid #ac9; +} \ No newline at end of file diff --git a/doc/build/html/_static/doctools.js b/doc/build/html/_static/doctools.js new file mode 100644 index 0000000..8614442 --- /dev/null +++ b/doc/build/html/_static/doctools.js @@ -0,0 +1,235 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s == 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node) { + if (node.nodeType == 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { + var span = document.createElement("span"); + span.className = className; + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this); + }); + } + } + return this.each(function() { + highlight(this); + }); +}; + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated == 'undefined') + return string; + return (typeof translated == 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated == 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) == 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this == '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); diff --git a/doc/build/html/_static/down-pressed.png b/doc/build/html/_static/down-pressed.png new file mode 100644 index 0000000..6f7ad78 Binary files /dev/null and b/doc/build/html/_static/down-pressed.png differ diff --git a/doc/build/html/_static/down.png b/doc/build/html/_static/down.png new file mode 100644 index 0000000..3003a88 Binary files /dev/null and b/doc/build/html/_static/down.png differ diff --git a/doc/build/html/_static/file.png b/doc/build/html/_static/file.png new file mode 100644 index 0000000..d18082e Binary files /dev/null and b/doc/build/html/_static/file.png differ diff --git a/doc/build/html/_static/jquery.js b/doc/build/html/_static/jquery.js new file mode 100644 index 0000000..83589da --- /dev/null +++ b/doc/build/html/_static/jquery.js @@ -0,0 +1,2 @@ +/*! jQuery v1.8.3 jquery.com | jquery.org/license */ +(function(e,t){function _(e){var t=M[e]={};return v.each(e.split(y),function(e,n){t[n]=!0}),t}function H(e,n,r){if(r===t&&e.nodeType===1){var i="data-"+n.replace(P,"-$1").toLowerCase();r=e.getAttribute(i);if(typeof r=="string"){try{r=r==="true"?!0:r==="false"?!1:r==="null"?null:+r+""===r?+r:D.test(r)?v.parseJSON(r):r}catch(s){}v.data(e,n,r)}else r=t}return r}function B(e){var t;for(t in e){if(t==="data"&&v.isEmptyObject(e[t]))continue;if(t!=="toJSON")return!1}return!0}function et(){return!1}function tt(){return!0}function ut(e){return!e||!e.parentNode||e.parentNode.nodeType===11}function at(e,t){do e=e[t];while(e&&e.nodeType!==1);return e}function ft(e,t,n){t=t||0;if(v.isFunction(t))return v.grep(e,function(e,r){var i=!!t.call(e,r,e);return i===n});if(t.nodeType)return v.grep(e,function(e,r){return e===t===n});if(typeof t=="string"){var r=v.grep(e,function(e){return e.nodeType===1});if(it.test(t))return v.filter(t,r,!n);t=v.filter(t,r)}return v.grep(e,function(e,r){return v.inArray(e,t)>=0===n})}function lt(e){var t=ct.split("|"),n=e.createDocumentFragment();if(n.createElement)while(t.length)n.createElement(t.pop());return n}function Lt(e,t){return e.getElementsByTagName(t)[0]||e.appendChild(e.ownerDocument.createElement(t))}function At(e,t){if(t.nodeType!==1||!v.hasData(e))return;var n,r,i,s=v._data(e),o=v._data(t,s),u=s.events;if(u){delete o.handle,o.events={};for(n in u)for(r=0,i=u[n].length;r").appendTo(i.body),n=t.css("display");t.remove();if(n==="none"||n===""){Pt=i.body.appendChild(Pt||v.extend(i.createElement("iframe"),{frameBorder:0,width:0,height:0}));if(!Ht||!Pt.createElement)Ht=(Pt.contentWindow||Pt.contentDocument).document,Ht.write(""),Ht.close();t=Ht.body.appendChild(Ht.createElement(e)),n=Dt(t,"display"),i.body.removeChild(Pt)}return Wt[e]=n,n}function fn(e,t,n,r){var i;if(v.isArray(t))v.each(t,function(t,i){n||sn.test(e)?r(e,i):fn(e+"["+(typeof i=="object"?t:"")+"]",i,n,r)});else if(!n&&v.type(t)==="object")for(i in t)fn(e+"["+i+"]",t[i],n,r);else r(e,t)}function Cn(e){return function(t,n){typeof t!="string"&&(n=t,t="*");var r,i,s,o=t.toLowerCase().split(y),u=0,a=o.length;if(v.isFunction(n))for(;u)[^>]*$|#([\w\-]*)$)/,E=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,S=/^[\],:{}\s]*$/,x=/(?:^|:|,)(?:\s*\[)+/g,T=/\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g,N=/"[^"\\\r\n]*"|true|false|null|-?(?:\d\d*\.|)\d+(?:[eE][\-+]?\d+|)/g,C=/^-ms-/,k=/-([\da-z])/gi,L=function(e,t){return(t+"").toUpperCase()},A=function(){i.addEventListener?(i.removeEventListener("DOMContentLoaded",A,!1),v.ready()):i.readyState==="complete"&&(i.detachEvent("onreadystatechange",A),v.ready())},O={};v.fn=v.prototype={constructor:v,init:function(e,n,r){var s,o,u,a;if(!e)return this;if(e.nodeType)return this.context=this[0]=e,this.length=1,this;if(typeof e=="string"){e.charAt(0)==="<"&&e.charAt(e.length-1)===">"&&e.length>=3?s=[null,e,null]:s=w.exec(e);if(s&&(s[1]||!n)){if(s[1])return n=n instanceof v?n[0]:n,a=n&&n.nodeType?n.ownerDocument||n:i,e=v.parseHTML(s[1],a,!0),E.test(s[1])&&v.isPlainObject(n)&&this.attr.call(e,n,!0),v.merge(this,e);o=i.getElementById(s[2]);if(o&&o.parentNode){if(o.id!==s[2])return r.find(e);this.length=1,this[0]=o}return this.context=i,this.selector=e,this}return!n||n.jquery?(n||r).find(e):this.constructor(n).find(e)}return v.isFunction(e)?r.ready(e):(e.selector!==t&&(this.selector=e.selector,this.context=e.context),v.makeArray(e,this))},selector:"",jquery:"1.8.3",length:0,size:function(){return this.length},toArray:function(){return l.call(this)},get:function(e){return e==null?this.toArray():e<0?this[this.length+e]:this[e]},pushStack:function(e,t,n){var r=v.merge(this.constructor(),e);return r.prevObject=this,r.context=this.context,t==="find"?r.selector=this.selector+(this.selector?" ":"")+n:t&&(r.selector=this.selector+"."+t+"("+n+")"),r},each:function(e,t){return v.each(this,e,t)},ready:function(e){return v.ready.promise().done(e),this},eq:function(e){return e=+e,e===-1?this.slice(e):this.slice(e,e+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(l.apply(this,arguments),"slice",l.call(arguments).join(","))},map:function(e){return this.pushStack(v.map(this,function(t,n){return e.call(t,n,t)}))},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:[].sort,splice:[].splice},v.fn.init.prototype=v.fn,v.extend=v.fn.extend=function(){var e,n,r,i,s,o,u=arguments[0]||{},a=1,f=arguments.length,l=!1;typeof u=="boolean"&&(l=u,u=arguments[1]||{},a=2),typeof u!="object"&&!v.isFunction(u)&&(u={}),f===a&&(u=this,--a);for(;a0)return;r.resolveWith(i,[v]),v.fn.trigger&&v(i).trigger("ready").off("ready")},isFunction:function(e){return v.type(e)==="function"},isArray:Array.isArray||function(e){return v.type(e)==="array"},isWindow:function(e){return e!=null&&e==e.window},isNumeric:function(e){return!isNaN(parseFloat(e))&&isFinite(e)},type:function(e){return e==null?String(e):O[h.call(e)]||"object"},isPlainObject:function(e){if(!e||v.type(e)!=="object"||e.nodeType||v.isWindow(e))return!1;try{if(e.constructor&&!p.call(e,"constructor")&&!p.call(e.constructor.prototype,"isPrototypeOf"))return!1}catch(n){return!1}var r;for(r in e);return r===t||p.call(e,r)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},error:function(e){throw new Error(e)},parseHTML:function(e,t,n){var r;return!e||typeof e!="string"?null:(typeof t=="boolean"&&(n=t,t=0),t=t||i,(r=E.exec(e))?[t.createElement(r[1])]:(r=v.buildFragment([e],t,n?null:[]),v.merge([],(r.cacheable?v.clone(r.fragment):r.fragment).childNodes)))},parseJSON:function(t){if(!t||typeof t!="string")return null;t=v.trim(t);if(e.JSON&&e.JSON.parse)return e.JSON.parse(t);if(S.test(t.replace(T,"@").replace(N,"]").replace(x,"")))return(new Function("return "+t))();v.error("Invalid JSON: "+t)},parseXML:function(n){var r,i;if(!n||typeof n!="string")return null;try{e.DOMParser?(i=new DOMParser,r=i.parseFromString(n,"text/xml")):(r=new ActiveXObject("Microsoft.XMLDOM"),r.async="false",r.loadXML(n))}catch(s){r=t}return(!r||!r.documentElement||r.getElementsByTagName("parsererror").length)&&v.error("Invalid XML: "+n),r},noop:function(){},globalEval:function(t){t&&g.test(t)&&(e.execScript||function(t){e.eval.call(e,t)})(t)},camelCase:function(e){return e.replace(C,"ms-").replace(k,L)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,n,r){var i,s=0,o=e.length,u=o===t||v.isFunction(e);if(r){if(u){for(i in e)if(n.apply(e[i],r)===!1)break}else for(;s0&&e[0]&&e[a-1]||a===0||v.isArray(e));if(f)for(;u-1)a.splice(n,1),i&&(n<=o&&o--,n<=u&&u--)}),this},has:function(e){return v.inArray(e,a)>-1},empty:function(){return a=[],this},disable:function(){return a=f=n=t,this},disabled:function(){return!a},lock:function(){return f=t,n||c.disable(),this},locked:function(){return!f},fireWith:function(e,t){return t=t||[],t=[e,t.slice?t.slice():t],a&&(!r||f)&&(i?f.push(t):l(t)),this},fire:function(){return c.fireWith(this,arguments),this},fired:function(){return!!r}};return c},v.extend({Deferred:function(e){var t=[["resolve","done",v.Callbacks("once memory"),"resolved"],["reject","fail",v.Callbacks("once memory"),"rejected"],["notify","progress",v.Callbacks("memory")]],n="pending",r={state:function(){return n},always:function(){return i.done(arguments).fail(arguments),this},then:function(){var e=arguments;return v.Deferred(function(n){v.each(t,function(t,r){var s=r[0],o=e[t];i[r[1]](v.isFunction(o)?function(){var e=o.apply(this,arguments);e&&v.isFunction(e.promise)?e.promise().done(n.resolve).fail(n.reject).progress(n.notify):n[s+"With"](this===i?n:this,[e])}:n[s])}),e=null}).promise()},promise:function(e){return e!=null?v.extend(e,r):r}},i={};return r.pipe=r.then,v.each(t,function(e,s){var o=s[2],u=s[3];r[s[1]]=o.add,u&&o.add(function(){n=u},t[e^1][2].disable,t[2][2].lock),i[s[0]]=o.fire,i[s[0]+"With"]=o.fireWith}),r.promise(i),e&&e.call(i,i),i},when:function(e){var t=0,n=l.call(arguments),r=n.length,i=r!==1||e&&v.isFunction(e.promise)?r:0,s=i===1?e:v.Deferred(),o=function(e,t,n){return function(r){t[e]=this,n[e]=arguments.length>1?l.call(arguments):r,n===u?s.notifyWith(t,n):--i||s.resolveWith(t,n)}},u,a,f;if(r>1){u=new Array(r),a=new Array(r),f=new Array(r);for(;t
a",n=p.getElementsByTagName("*"),r=p.getElementsByTagName("a")[0];if(!n||!r||!n.length)return{};s=i.createElement("select"),o=s.appendChild(i.createElement("option")),u=p.getElementsByTagName("input")[0],r.style.cssText="top:1px;float:left;opacity:.5",t={leadingWhitespace:p.firstChild.nodeType===3,tbody:!p.getElementsByTagName("tbody").length,htmlSerialize:!!p.getElementsByTagName("link").length,style:/top/.test(r.getAttribute("style")),hrefNormalized:r.getAttribute("href")==="/a",opacity:/^0.5/.test(r.style.opacity),cssFloat:!!r.style.cssFloat,checkOn:u.value==="on",optSelected:o.selected,getSetAttribute:p.className!=="t",enctype:!!i.createElement("form").enctype,html5Clone:i.createElement("nav").cloneNode(!0).outerHTML!=="<:nav>",boxModel:i.compatMode==="CSS1Compat",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0,boxSizingReliable:!0,pixelPosition:!1},u.checked=!0,t.noCloneChecked=u.cloneNode(!0).checked,s.disabled=!0,t.optDisabled=!o.disabled;try{delete p.test}catch(d){t.deleteExpando=!1}!p.addEventListener&&p.attachEvent&&p.fireEvent&&(p.attachEvent("onclick",h=function(){t.noCloneEvent=!1}),p.cloneNode(!0).fireEvent("onclick"),p.detachEvent("onclick",h)),u=i.createElement("input"),u.value="t",u.setAttribute("type","radio"),t.radioValue=u.value==="t",u.setAttribute("checked","checked"),u.setAttribute("name","t"),p.appendChild(u),a=i.createDocumentFragment(),a.appendChild(p.lastChild),t.checkClone=a.cloneNode(!0).cloneNode(!0).lastChild.checked,t.appendChecked=u.checked,a.removeChild(u),a.appendChild(p);if(p.attachEvent)for(l in{submit:!0,change:!0,focusin:!0})f="on"+l,c=f in p,c||(p.setAttribute(f,"return;"),c=typeof p[f]=="function"),t[l+"Bubbles"]=c;return v(function(){var n,r,s,o,u="padding:0;margin:0;border:0;display:block;overflow:hidden;",a=i.getElementsByTagName("body")[0];if(!a)return;n=i.createElement("div"),n.style.cssText="visibility:hidden;border:0;width:0;height:0;position:static;top:0;margin-top:1px",a.insertBefore(n,a.firstChild),r=i.createElement("div"),n.appendChild(r),r.innerHTML="
t
",s=r.getElementsByTagName("td"),s[0].style.cssText="padding:0;margin:0;border:0;display:none",c=s[0].offsetHeight===0,s[0].style.display="",s[1].style.display="none",t.reliableHiddenOffsets=c&&s[0].offsetHeight===0,r.innerHTML="",r.style.cssText="box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;",t.boxSizing=r.offsetWidth===4,t.doesNotIncludeMarginInBodyOffset=a.offsetTop!==1,e.getComputedStyle&&(t.pixelPosition=(e.getComputedStyle(r,null)||{}).top!=="1%",t.boxSizingReliable=(e.getComputedStyle(r,null)||{width:"4px"}).width==="4px",o=i.createElement("div"),o.style.cssText=r.style.cssText=u,o.style.marginRight=o.style.width="0",r.style.width="1px",r.appendChild(o),t.reliableMarginRight=!parseFloat((e.getComputedStyle(o,null)||{}).marginRight)),typeof r.style.zoom!="undefined"&&(r.innerHTML="",r.style.cssText=u+"width:1px;padding:1px;display:inline;zoom:1",t.inlineBlockNeedsLayout=r.offsetWidth===3,r.style.display="block",r.style.overflow="visible",r.innerHTML="
",r.firstChild.style.width="5px",t.shrinkWrapBlocks=r.offsetWidth!==3,n.style.zoom=1),a.removeChild(n),n=r=s=o=null}),a.removeChild(p),n=r=s=o=u=a=p=null,t}();var D=/(?:\{[\s\S]*\}|\[[\s\S]*\])$/,P=/([A-Z])/g;v.extend({cache:{},deletedIds:[],uuid:0,expando:"jQuery"+(v.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(e){return e=e.nodeType?v.cache[e[v.expando]]:e[v.expando],!!e&&!B(e)},data:function(e,n,r,i){if(!v.acceptData(e))return;var s,o,u=v.expando,a=typeof n=="string",f=e.nodeType,l=f?v.cache:e,c=f?e[u]:e[u]&&u;if((!c||!l[c]||!i&&!l[c].data)&&a&&r===t)return;c||(f?e[u]=c=v.deletedIds.pop()||v.guid++:c=u),l[c]||(l[c]={},f||(l[c].toJSON=v.noop));if(typeof n=="object"||typeof n=="function")i?l[c]=v.extend(l[c],n):l[c].data=v.extend(l[c].data,n);return s=l[c],i||(s.data||(s.data={}),s=s.data),r!==t&&(s[v.camelCase(n)]=r),a?(o=s[n],o==null&&(o=s[v.camelCase(n)])):o=s,o},removeData:function(e,t,n){if(!v.acceptData(e))return;var r,i,s,o=e.nodeType,u=o?v.cache:e,a=o?e[v.expando]:v.expando;if(!u[a])return;if(t){r=n?u[a]:u[a].data;if(r){v.isArray(t)||(t in r?t=[t]:(t=v.camelCase(t),t in r?t=[t]:t=t.split(" ")));for(i=0,s=t.length;i1,null,!1))},removeData:function(e){return this.each(function(){v.removeData(this,e)})}}),v.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=v._data(e,t),n&&(!r||v.isArray(n)?r=v._data(e,t,v.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=v.queue(e,t),r=n.length,i=n.shift(),s=v._queueHooks(e,t),o=function(){v.dequeue(e,t)};i==="inprogress"&&(i=n.shift(),r--),i&&(t==="fx"&&n.unshift("inprogress"),delete s.stop,i.call(e,o,s)),!r&&s&&s.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return v._data(e,n)||v._data(e,n,{empty:v.Callbacks("once memory").add(function(){v.removeData(e,t+"queue",!0),v.removeData(e,n,!0)})})}}),v.fn.extend({queue:function(e,n){var r=2;return typeof e!="string"&&(n=e,e="fx",r--),arguments.length1)},removeAttr:function(e){return this.each(function(){v.removeAttr(this,e)})},prop:function(e,t){return v.access(this,v.prop,e,t,arguments.length>1)},removeProp:function(e){return e=v.propFix[e]||e,this.each(function(){try{this[e]=t,delete this[e]}catch(n){}})},addClass:function(e){var t,n,r,i,s,o,u;if(v.isFunction(e))return this.each(function(t){v(this).addClass(e.call(this,t,this.className))});if(e&&typeof e=="string"){t=e.split(y);for(n=0,r=this.length;n=0)r=r.replace(" "+n[s]+" "," ");i.className=e?v.trim(r):""}}}return this},toggleClass:function(e,t){var n=typeof e,r=typeof t=="boolean";return v.isFunction(e)?this.each(function(n){v(this).toggleClass(e.call(this,n,this.className,t),t)}):this.each(function(){if(n==="string"){var i,s=0,o=v(this),u=t,a=e.split(y);while(i=a[s++])u=r?u:!o.hasClass(i),o[u?"addClass":"removeClass"](i)}else if(n==="undefined"||n==="boolean")this.className&&v._data(this,"__className__",this.className),this.className=this.className||e===!1?"":v._data(this,"__className__")||""})},hasClass:function(e){var t=" "+e+" ",n=0,r=this.length;for(;n=0)return!0;return!1},val:function(e){var n,r,i,s=this[0];if(!arguments.length){if(s)return n=v.valHooks[s.type]||v.valHooks[s.nodeName.toLowerCase()],n&&"get"in n&&(r=n.get(s,"value"))!==t?r:(r=s.value,typeof r=="string"?r.replace(R,""):r==null?"":r);return}return i=v.isFunction(e),this.each(function(r){var s,o=v(this);if(this.nodeType!==1)return;i?s=e.call(this,r,o.val()):s=e,s==null?s="":typeof s=="number"?s+="":v.isArray(s)&&(s=v.map(s,function(e){return e==null?"":e+""})),n=v.valHooks[this.type]||v.valHooks[this.nodeName.toLowerCase()];if(!n||!("set"in n)||n.set(this,s,"value")===t)this.value=s})}}),v.extend({valHooks:{option:{get:function(e){var t=e.attributes.value;return!t||t.specified?e.value:e.text}},select:{get:function(e){var t,n,r=e.options,i=e.selectedIndex,s=e.type==="select-one"||i<0,o=s?null:[],u=s?i+1:r.length,a=i<0?u:s?i:0;for(;a=0}),n.length||(e.selectedIndex=-1),n}}},attrFn:{},attr:function(e,n,r,i){var s,o,u,a=e.nodeType;if(!e||a===3||a===8||a===2)return;if(i&&v.isFunction(v.fn[n]))return v(e)[n](r);if(typeof e.getAttribute=="undefined")return v.prop(e,n,r);u=a!==1||!v.isXMLDoc(e),u&&(n=n.toLowerCase(),o=v.attrHooks[n]||(X.test(n)?F:j));if(r!==t){if(r===null){v.removeAttr(e,n);return}return o&&"set"in o&&u&&(s=o.set(e,r,n))!==t?s:(e.setAttribute(n,r+""),r)}return o&&"get"in o&&u&&(s=o.get(e,n))!==null?s:(s=e.getAttribute(n),s===null?t:s)},removeAttr:function(e,t){var n,r,i,s,o=0;if(t&&e.nodeType===1){r=t.split(y);for(;o=0}})});var $=/^(?:textarea|input|select)$/i,J=/^([^\.]*|)(?:\.(.+)|)$/,K=/(?:^|\s)hover(\.\S+|)\b/,Q=/^key/,G=/^(?:mouse|contextmenu)|click/,Y=/^(?:focusinfocus|focusoutblur)$/,Z=function(e){return v.event.special.hover?e:e.replace(K,"mouseenter$1 mouseleave$1")};v.event={add:function(e,n,r,i,s){var o,u,a,f,l,c,h,p,d,m,g;if(e.nodeType===3||e.nodeType===8||!n||!r||!(o=v._data(e)))return;r.handler&&(d=r,r=d.handler,s=d.selector),r.guid||(r.guid=v.guid++),a=o.events,a||(o.events=a={}),u=o.handle,u||(o.handle=u=function(e){return typeof v=="undefined"||!!e&&v.event.triggered===e.type?t:v.event.dispatch.apply(u.elem,arguments)},u.elem=e),n=v.trim(Z(n)).split(" ");for(f=0;f=0&&(y=y.slice(0,-1),a=!0),y.indexOf(".")>=0&&(b=y.split("."),y=b.shift(),b.sort());if((!s||v.event.customEvent[y])&&!v.event.global[y])return;n=typeof n=="object"?n[v.expando]?n:new v.Event(y,n):new v.Event(y),n.type=y,n.isTrigger=!0,n.exclusive=a,n.namespace=b.join("."),n.namespace_re=n.namespace?new RegExp("(^|\\.)"+b.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,h=y.indexOf(":")<0?"on"+y:"";if(!s){u=v.cache;for(f in u)u[f].events&&u[f].events[y]&&v.event.trigger(n,r,u[f].handle.elem,!0);return}n.result=t,n.target||(n.target=s),r=r!=null?v.makeArray(r):[],r.unshift(n),p=v.event.special[y]||{};if(p.trigger&&p.trigger.apply(s,r)===!1)return;m=[[s,p.bindType||y]];if(!o&&!p.noBubble&&!v.isWindow(s)){g=p.delegateType||y,l=Y.test(g+y)?s:s.parentNode;for(c=s;l;l=l.parentNode)m.push([l,g]),c=l;c===(s.ownerDocument||i)&&m.push([c.defaultView||c.parentWindow||e,g])}for(f=0;f=0:v.find(h,this,null,[s]).length),u[h]&&f.push(c);f.length&&w.push({elem:s,matches:f})}d.length>m&&w.push({elem:this,matches:d.slice(m)});for(r=0;r0?this.on(t,null,e,n):this.trigger(t)},Q.test(t)&&(v.event.fixHooks[t]=v.event.keyHooks),G.test(t)&&(v.event.fixHooks[t]=v.event.mouseHooks)}),function(e,t){function nt(e,t,n,r){n=n||[],t=t||g;var i,s,a,f,l=t.nodeType;if(!e||typeof e!="string")return n;if(l!==1&&l!==9)return[];a=o(t);if(!a&&!r)if(i=R.exec(e))if(f=i[1]){if(l===9){s=t.getElementById(f);if(!s||!s.parentNode)return n;if(s.id===f)return n.push(s),n}else if(t.ownerDocument&&(s=t.ownerDocument.getElementById(f))&&u(t,s)&&s.id===f)return n.push(s),n}else{if(i[2])return S.apply(n,x.call(t.getElementsByTagName(e),0)),n;if((f=i[3])&&Z&&t.getElementsByClassName)return S.apply(n,x.call(t.getElementsByClassName(f),0)),n}return vt(e.replace(j,"$1"),t,n,r,a)}function rt(e){return function(t){var n=t.nodeName.toLowerCase();return n==="input"&&t.type===e}}function it(e){return function(t){var n=t.nodeName.toLowerCase();return(n==="input"||n==="button")&&t.type===e}}function st(e){return N(function(t){return t=+t,N(function(n,r){var i,s=e([],n.length,t),o=s.length;while(o--)n[i=s[o]]&&(n[i]=!(r[i]=n[i]))})})}function ot(e,t,n){if(e===t)return n;var r=e.nextSibling;while(r){if(r===t)return-1;r=r.nextSibling}return 1}function ut(e,t){var n,r,s,o,u,a,f,l=L[d][e+" "];if(l)return t?0:l.slice(0);u=e,a=[],f=i.preFilter;while(u){if(!n||(r=F.exec(u)))r&&(u=u.slice(r[0].length)||u),a.push(s=[]);n=!1;if(r=I.exec(u))s.push(n=new m(r.shift())),u=u.slice(n.length),n.type=r[0].replace(j," ");for(o in i.filter)(r=J[o].exec(u))&&(!f[o]||(r=f[o](r)))&&(s.push(n=new m(r.shift())),u=u.slice(n.length),n.type=o,n.matches=r);if(!n)break}return t?u.length:u?nt.error(e):L(e,a).slice(0)}function at(e,t,r){var i=t.dir,s=r&&t.dir==="parentNode",o=w++;return t.first?function(t,n,r){while(t=t[i])if(s||t.nodeType===1)return e(t,n,r)}:function(t,r,u){if(!u){var a,f=b+" "+o+" ",l=f+n;while(t=t[i])if(s||t.nodeType===1){if((a=t[d])===l)return t.sizset;if(typeof a=="string"&&a.indexOf(f)===0){if(t.sizset)return t}else{t[d]=l;if(e(t,r,u))return t.sizset=!0,t;t.sizset=!1}}}else while(t=t[i])if(s||t.nodeType===1)if(e(t,r,u))return t}}function ft(e){return e.length>1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function lt(e,t,n,r,i){var s,o=[],u=0,a=e.length,f=t!=null;for(;u-1&&(s[f]=!(o[f]=c))}}else g=lt(g===o?g.splice(d,g.length):g),i?i(null,o,g,a):S.apply(o,g)})}function ht(e){var t,n,r,s=e.length,o=i.relative[e[0].type],u=o||i.relative[" "],a=o?1:0,f=at(function(e){return e===t},u,!0),l=at(function(e){return T.call(t,e)>-1},u,!0),h=[function(e,n,r){return!o&&(r||n!==c)||((t=n).nodeType?f(e,n,r):l(e,n,r))}];for(;a1&&ft(h),a>1&&e.slice(0,a-1).join("").replace(j,"$1"),n,a0,s=e.length>0,o=function(u,a,f,l,h){var p,d,v,m=[],y=0,w="0",x=u&&[],T=h!=null,N=c,C=u||s&&i.find.TAG("*",h&&a.parentNode||a),k=b+=N==null?1:Math.E;T&&(c=a!==g&&a,n=o.el);for(;(p=C[w])!=null;w++){if(s&&p){for(d=0;v=e[d];d++)if(v(p,a,f)){l.push(p);break}T&&(b=k,n=++o.el)}r&&((p=!v&&p)&&y--,u&&x.push(p))}y+=w;if(r&&w!==y){for(d=0;v=t[d];d++)v(x,m,a,f);if(u){if(y>0)while(w--)!x[w]&&!m[w]&&(m[w]=E.call(l));m=lt(m)}S.apply(l,m),T&&!u&&m.length>0&&y+t.length>1&&nt.uniqueSort(l)}return T&&(b=k,c=N),x};return o.el=0,r?N(o):o}function dt(e,t,n){var r=0,i=t.length;for(;r2&&(f=u[0]).type==="ID"&&t.nodeType===9&&!s&&i.relative[u[1].type]){t=i.find.ID(f.matches[0].replace($,""),t,s)[0];if(!t)return n;e=e.slice(u.shift().length)}for(o=J.POS.test(e)?-1:u.length-1;o>=0;o--){f=u[o];if(i.relative[l=f.type])break;if(c=i.find[l])if(r=c(f.matches[0].replace($,""),z.test(u[0].type)&&t.parentNode||t,s)){u.splice(o,1),e=r.length&&u.join("");if(!e)return S.apply(n,x.call(r,0)),n;break}}}return a(e,h)(r,t,s,n,z.test(e)),n}function mt(){}var n,r,i,s,o,u,a,f,l,c,h=!0,p="undefined",d=("sizcache"+Math.random()).replace(".",""),m=String,g=e.document,y=g.documentElement,b=0,w=0,E=[].pop,S=[].push,x=[].slice,T=[].indexOf||function(e){var t=0,n=this.length;for(;ti.cacheLength&&delete e[t.shift()],e[n+" "]=r},e)},k=C(),L=C(),A=C(),O="[\\x20\\t\\r\\n\\f]",M="(?:\\\\.|[-\\w]|[^\\x00-\\xa0])+",_=M.replace("w","w#"),D="([*^$|!~]?=)",P="\\["+O+"*("+M+")"+O+"*(?:"+D+O+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+_+")|)|)"+O+"*\\]",H=":("+M+")(?:\\((?:(['\"])((?:\\\\.|[^\\\\])*?)\\2|([^()[\\]]*|(?:(?:"+P+")|[^:]|\\\\.)*|.*))\\)|)",B=":(even|odd|eq|gt|lt|nth|first|last)(?:\\("+O+"*((?:-\\d)?\\d*)"+O+"*\\)|)(?=[^-]|$)",j=new RegExp("^"+O+"+|((?:^|[^\\\\])(?:\\\\.)*)"+O+"+$","g"),F=new RegExp("^"+O+"*,"+O+"*"),I=new RegExp("^"+O+"*([\\x20\\t\\r\\n\\f>+~])"+O+"*"),q=new RegExp(H),R=/^(?:#([\w\-]+)|(\w+)|\.([\w\-]+))$/,U=/^:not/,z=/[\x20\t\r\n\f]*[+~]/,W=/:not\($/,X=/h\d/i,V=/input|select|textarea|button/i,$=/\\(?!\\)/g,J={ID:new RegExp("^#("+M+")"),CLASS:new RegExp("^\\.("+M+")"),NAME:new RegExp("^\\[name=['\"]?("+M+")['\"]?\\]"),TAG:new RegExp("^("+M.replace("w","w*")+")"),ATTR:new RegExp("^"+P),PSEUDO:new RegExp("^"+H),POS:new RegExp(B,"i"),CHILD:new RegExp("^:(only|nth|first|last)-child(?:\\("+O+"*(even|odd|(([+-]|)(\\d*)n|)"+O+"*(?:([+-]|)"+O+"*(\\d+)|))"+O+"*\\)|)","i"),needsContext:new RegExp("^"+O+"*[>+~]|"+B,"i")},K=function(e){var t=g.createElement("div");try{return e(t)}catch(n){return!1}finally{t=null}},Q=K(function(e){return e.appendChild(g.createComment("")),!e.getElementsByTagName("*").length}),G=K(function(e){return e.innerHTML="",e.firstChild&&typeof e.firstChild.getAttribute!==p&&e.firstChild.getAttribute("href")==="#"}),Y=K(function(e){e.innerHTML="";var t=typeof e.lastChild.getAttribute("multiple");return t!=="boolean"&&t!=="string"}),Z=K(function(e){return e.innerHTML="",!e.getElementsByClassName||!e.getElementsByClassName("e").length?!1:(e.lastChild.className="e",e.getElementsByClassName("e").length===2)}),et=K(function(e){e.id=d+0,e.innerHTML="
",y.insertBefore(e,y.firstChild);var t=g.getElementsByName&&g.getElementsByName(d).length===2+g.getElementsByName(d+0).length;return r=!g.getElementById(d),y.removeChild(e),t});try{x.call(y.childNodes,0)[0].nodeType}catch(tt){x=function(e){var t,n=[];for(;t=this[e];e++)n.push(t);return n}}nt.matches=function(e,t){return nt(e,null,null,t)},nt.matchesSelector=function(e,t){return nt(t,null,null,[e]).length>0},s=nt.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(i===1||i===9||i===11){if(typeof e.textContent=="string")return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=s(e)}else if(i===3||i===4)return e.nodeValue}else for(;t=e[r];r++)n+=s(t);return n},o=nt.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?t.nodeName!=="HTML":!1},u=nt.contains=y.contains?function(e,t){var n=e.nodeType===9?e.documentElement:e,r=t&&t.parentNode;return e===r||!!(r&&r.nodeType===1&&n.contains&&n.contains(r))}:y.compareDocumentPosition?function(e,t){return t&&!!(e.compareDocumentPosition(t)&16)}:function(e,t){while(t=t.parentNode)if(t===e)return!0;return!1},nt.attr=function(e,t){var n,r=o(e);return r||(t=t.toLowerCase()),(n=i.attrHandle[t])?n(e):r||Y?e.getAttribute(t):(n=e.getAttributeNode(t),n?typeof e[t]=="boolean"?e[t]?t:null:n.specified?n.value:null:null)},i=nt.selectors={cacheLength:50,createPseudo:N,match:J,attrHandle:G?{}:{href:function(e){return e.getAttribute("href",2)},type:function(e){return e.getAttribute("type")}},find:{ID:r?function(e,t,n){if(typeof t.getElementById!==p&&!n){var r=t.getElementById(e);return r&&r.parentNode?[r]:[]}}:function(e,n,r){if(typeof n.getElementById!==p&&!r){var i=n.getElementById(e);return i?i.id===e||typeof i.getAttributeNode!==p&&i.getAttributeNode("id").value===e?[i]:t:[]}},TAG:Q?function(e,t){if(typeof t.getElementsByTagName!==p)return t.getElementsByTagName(e)}:function(e,t){var n=t.getElementsByTagName(e);if(e==="*"){var r,i=[],s=0;for(;r=n[s];s++)r.nodeType===1&&i.push(r);return i}return n},NAME:et&&function(e,t){if(typeof t.getElementsByName!==p)return t.getElementsByName(name)},CLASS:Z&&function(e,t,n){if(typeof t.getElementsByClassName!==p&&!n)return t.getElementsByClassName(e)}},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace($,""),e[3]=(e[4]||e[5]||"").replace($,""),e[2]==="~="&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),e[1]==="nth"?(e[2]||nt.error(e[0]),e[3]=+(e[3]?e[4]+(e[5]||1):2*(e[2]==="even"||e[2]==="odd")),e[4]=+(e[6]+e[7]||e[2]==="odd")):e[2]&&nt.error(e[0]),e},PSEUDO:function(e){var t,n;if(J.CHILD.test(e[0]))return null;if(e[3])e[2]=e[3];else if(t=e[4])q.test(t)&&(n=ut(t,!0))&&(n=t.indexOf(")",t.length-n)-t.length)&&(t=t.slice(0,n),e[0]=e[0].slice(0,n)),e[2]=t;return e.slice(0,3)}},filter:{ID:r?function(e){return e=e.replace($,""),function(t){return t.getAttribute("id")===e}}:function(e){return e=e.replace($,""),function(t){var n=typeof t.getAttributeNode!==p&&t.getAttributeNode("id");return n&&n.value===e}},TAG:function(e){return e==="*"?function(){return!0}:(e=e.replace($,"").toLowerCase(),function(t){return t.nodeName&&t.nodeName.toLowerCase()===e})},CLASS:function(e){var t=k[d][e+" "];return t||(t=new RegExp("(^|"+O+")"+e+"("+O+"|$)"))&&k(e,function(e){return t.test(e.className||typeof e.getAttribute!==p&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r,i){var s=nt.attr(r,e);return s==null?t==="!=":t?(s+="",t==="="?s===n:t==="!="?s!==n:t==="^="?n&&s.indexOf(n)===0:t==="*="?n&&s.indexOf(n)>-1:t==="$="?n&&s.substr(s.length-n.length)===n:t==="~="?(" "+s+" ").indexOf(n)>-1:t==="|="?s===n||s.substr(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r){return e==="nth"?function(e){var t,i,s=e.parentNode;if(n===1&&r===0)return!0;if(s){i=0;for(t=s.firstChild;t;t=t.nextSibling)if(t.nodeType===1){i++;if(e===t)break}}return i-=r,i===n||i%n===0&&i/n>=0}:function(t){var n=t;switch(e){case"only":case"first":while(n=n.previousSibling)if(n.nodeType===1)return!1;if(e==="first")return!0;n=t;case"last":while(n=n.nextSibling)if(n.nodeType===1)return!1;return!0}}},PSEUDO:function(e,t){var n,r=i.pseudos[e]||i.setFilters[e.toLowerCase()]||nt.error("unsupported pseudo: "+e);return r[d]?r(t):r.length>1?(n=[e,e,"",t],i.setFilters.hasOwnProperty(e.toLowerCase())?N(function(e,n){var i,s=r(e,t),o=s.length;while(o--)i=T.call(e,s[o]),e[i]=!(n[i]=s[o])}):function(e){return r(e,0,n)}):r}},pseudos:{not:N(function(e){var t=[],n=[],r=a(e.replace(j,"$1"));return r[d]?N(function(e,t,n,i){var s,o=r(e,null,i,[]),u=e.length;while(u--)if(s=o[u])e[u]=!(t[u]=s)}):function(e,i,s){return t[0]=e,r(t,null,s,n),!n.pop()}}),has:N(function(e){return function(t){return nt(e,t).length>0}}),contains:N(function(e){return function(t){return(t.textContent||t.innerText||s(t)).indexOf(e)>-1}}),enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return t==="input"&&!!e.checked||t==="option"&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},parent:function(e){return!i.pseudos.empty(e)},empty:function(e){var t;e=e.firstChild;while(e){if(e.nodeName>"@"||(t=e.nodeType)===3||t===4)return!1;e=e.nextSibling}return!0},header:function(e){return X.test(e.nodeName)},text:function(e){var t,n;return e.nodeName.toLowerCase()==="input"&&(t=e.type)==="text"&&((n=e.getAttribute("type"))==null||n.toLowerCase()===t)},radio:rt("radio"),checkbox:rt("checkbox"),file:rt("file"),password:rt("password"),image:rt("image"),submit:it("submit"),reset:it("reset"),button:function(e){var t=e.nodeName.toLowerCase();return t==="input"&&e.type==="button"||t==="button"},input:function(e){return V.test(e.nodeName)},focus:function(e){var t=e.ownerDocument;return e===t.activeElement&&(!t.hasFocus||t.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},active:function(e){return e===e.ownerDocument.activeElement},first:st(function(){return[0]}),last:st(function(e,t){return[t-1]}),eq:st(function(e,t,n){return[n<0?n+t:n]}),even:st(function(e,t){for(var n=0;n=0;)e.push(r);return e}),gt:st(function(e,t,n){for(var r=n<0?n+t:n;++r",e.querySelectorAll("[selected]").length||i.push("\\["+O+"*(?:checked|disabled|ismap|multiple|readonly|selected|value)"),e.querySelectorAll(":checked").length||i.push(":checked")}),K(function(e){e.innerHTML="

",e.querySelectorAll("[test^='']").length&&i.push("[*^$]="+O+"*(?:\"\"|'')"),e.innerHTML="",e.querySelectorAll(":enabled").length||i.push(":enabled",":disabled")}),i=new RegExp(i.join("|")),vt=function(e,r,s,o,u){if(!o&&!u&&!i.test(e)){var a,f,l=!0,c=d,h=r,p=r.nodeType===9&&e;if(r.nodeType===1&&r.nodeName.toLowerCase()!=="object"){a=ut(e),(l=r.getAttribute("id"))?c=l.replace(n,"\\$&"):r.setAttribute("id",c),c="[id='"+c+"'] ",f=a.length;while(f--)a[f]=c+a[f].join("");h=z.test(e)&&r.parentNode||r,p=a.join(",")}if(p)try{return S.apply(s,x.call(h.querySelectorAll(p),0)),s}catch(v){}finally{l||r.removeAttribute("id")}}return t(e,r,s,o,u)},u&&(K(function(t){e=u.call(t,"div");try{u.call(t,"[test!='']:sizzle"),s.push("!=",H)}catch(n){}}),s=new RegExp(s.join("|")),nt.matchesSelector=function(t,n){n=n.replace(r,"='$1']");if(!o(t)&&!s.test(n)&&!i.test(n))try{var a=u.call(t,n);if(a||e||t.document&&t.document.nodeType!==11)return a}catch(f){}return nt(n,null,null,[t]).length>0})}(),i.pseudos.nth=i.pseudos.eq,i.filters=mt.prototype=i.pseudos,i.setFilters=new mt,nt.attr=v.attr,v.find=nt,v.expr=nt.selectors,v.expr[":"]=v.expr.pseudos,v.unique=nt.uniqueSort,v.text=nt.getText,v.isXMLDoc=nt.isXML,v.contains=nt.contains}(e);var nt=/Until$/,rt=/^(?:parents|prev(?:Until|All))/,it=/^.[^:#\[\.,]*$/,st=v.expr.match.needsContext,ot={children:!0,contents:!0,next:!0,prev:!0};v.fn.extend({find:function(e){var t,n,r,i,s,o,u=this;if(typeof e!="string")return v(e).filter(function(){for(t=0,n=u.length;t0)for(i=r;i=0:v.filter(e,this).length>0:this.filter(e).length>0)},closest:function(e,t){var n,r=0,i=this.length,s=[],o=st.test(e)||typeof e!="string"?v(e,t||this.context):0;for(;r-1:v.find.matchesSelector(n,e)){s.push(n);break}n=n.parentNode}}return s=s.length>1?v.unique(s):s,this.pushStack(s,"closest",e)},index:function(e){return e?typeof e=="string"?v.inArray(this[0],v(e)):v.inArray(e.jquery?e[0]:e,this):this[0]&&this[0].parentNode?this.prevAll().length:-1},add:function(e,t){var n=typeof e=="string"?v(e,t):v.makeArray(e&&e.nodeType?[e]:e),r=v.merge(this.get(),n);return this.pushStack(ut(n[0])||ut(r[0])?r:v.unique(r))},addBack:function(e){return this.add(e==null?this.prevObject:this.prevObject.filter(e))}}),v.fn.andSelf=v.fn.addBack,v.each({parent:function(e){var t=e.parentNode;return t&&t.nodeType!==11?t:null},parents:function(e){return v.dir(e,"parentNode")},parentsUntil:function(e,t,n){return v.dir(e,"parentNode",n)},next:function(e){return at(e,"nextSibling")},prev:function(e){return at(e,"previousSibling")},nextAll:function(e){return v.dir(e,"nextSibling")},prevAll:function(e){return v.dir(e,"previousSibling")},nextUntil:function(e,t,n){return v.dir(e,"nextSibling",n)},prevUntil:function(e,t,n){return v.dir(e,"previousSibling",n)},siblings:function(e){return v.sibling((e.parentNode||{}).firstChild,e)},children:function(e){return v.sibling(e.firstChild)},contents:function(e){return v.nodeName(e,"iframe")?e.contentDocument||e.contentWindow.document:v.merge([],e.childNodes)}},function(e,t){v.fn[e]=function(n,r){var i=v.map(this,t,n);return nt.test(e)||(r=n),r&&typeof r=="string"&&(i=v.filter(r,i)),i=this.length>1&&!ot[e]?v.unique(i):i,this.length>1&&rt.test(e)&&(i=i.reverse()),this.pushStack(i,e,l.call(arguments).join(","))}}),v.extend({filter:function(e,t,n){return n&&(e=":not("+e+")"),t.length===1?v.find.matchesSelector(t[0],e)?[t[0]]:[]:v.find.matches(e,t)},dir:function(e,n,r){var i=[],s=e[n];while(s&&s.nodeType!==9&&(r===t||s.nodeType!==1||!v(s).is(r)))s.nodeType===1&&i.push(s),s=s[n];return i},sibling:function(e,t){var n=[];for(;e;e=e.nextSibling)e.nodeType===1&&e!==t&&n.push(e);return n}});var ct="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",ht=/ jQuery\d+="(?:null|\d+)"/g,pt=/^\s+/,dt=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,vt=/<([\w:]+)/,mt=/]","i"),Et=/^(?:checkbox|radio)$/,St=/checked\s*(?:[^=]|=\s*.checked.)/i,xt=/\/(java|ecma)script/i,Tt=/^\s*\s*$/g,Nt={option:[1,""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]},Ct=lt(i),kt=Ct.appendChild(i.createElement("div"));Nt.optgroup=Nt.option,Nt.tbody=Nt.tfoot=Nt.colgroup=Nt.caption=Nt.thead,Nt.th=Nt.td,v.support.htmlSerialize||(Nt._default=[1,"X
","
"]),v.fn.extend({text:function(e){return v.access(this,function(e){return e===t?v.text(this):this.empty().append((this[0]&&this[0].ownerDocument||i).createTextNode(e))},null,e,arguments.length)},wrapAll:function(e){if(v.isFunction(e))return this.each(function(t){v(this).wrapAll(e.call(this,t))});if(this[0]){var t=v(e,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstChild&&e.firstChild.nodeType===1)e=e.firstChild;return e}).append(this)}return this},wrapInner:function(e){return v.isFunction(e)?this.each(function(t){v(this).wrapInner(e.call(this,t))}):this.each(function(){var t=v(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=v.isFunction(e);return this.each(function(n){v(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(){return this.parent().each(function(){v.nodeName(this,"body")||v(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(e){(this.nodeType===1||this.nodeType===11)&&this.appendChild(e)})},prepend:function(){return this.domManip(arguments,!0,function(e){(this.nodeType===1||this.nodeType===11)&&this.insertBefore(e,this.firstChild)})},before:function(){if(!ut(this[0]))return this.domManip(arguments,!1,function(e){this.parentNode.insertBefore(e,this)});if(arguments.length){var e=v.clean(arguments);return this.pushStack(v.merge(e,this),"before",this.selector)}},after:function(){if(!ut(this[0]))return this.domManip(arguments,!1,function(e){this.parentNode.insertBefore(e,this.nextSibling)});if(arguments.length){var e=v.clean(arguments);return this.pushStack(v.merge(this,e),"after",this.selector)}},remove:function(e,t){var n,r=0;for(;(n=this[r])!=null;r++)if(!e||v.filter(e,[n]).length)!t&&n.nodeType===1&&(v.cleanData(n.getElementsByTagName("*")),v.cleanData([n])),n.parentNode&&n.parentNode.removeChild(n);return this},empty:function(){var e,t=0;for(;(e=this[t])!=null;t++){e.nodeType===1&&v.cleanData(e.getElementsByTagName("*"));while(e.firstChild)e.removeChild(e.firstChild)}return this},clone:function(e,t){return e=e==null?!1:e,t=t==null?e:t,this.map(function(){return v.clone(this,e,t)})},html:function(e){return v.access(this,function(e){var n=this[0]||{},r=0,i=this.length;if(e===t)return n.nodeType===1?n.innerHTML.replace(ht,""):t;if(typeof e=="string"&&!yt.test(e)&&(v.support.htmlSerialize||!wt.test(e))&&(v.support.leadingWhitespace||!pt.test(e))&&!Nt[(vt.exec(e)||["",""])[1].toLowerCase()]){e=e.replace(dt,"<$1>");try{for(;r1&&typeof f=="string"&&St.test(f))return this.each(function(){v(this).domManip(e,n,r)});if(v.isFunction(f))return this.each(function(i){var s=v(this);e[0]=f.call(this,i,n?s.html():t),s.domManip(e,n,r)});if(this[0]){i=v.buildFragment(e,this,l),o=i.fragment,s=o.firstChild,o.childNodes.length===1&&(o=s);if(s){n=n&&v.nodeName(s,"tr");for(u=i.cacheable||c-1;a0?this.clone(!0):this).get(),v(o[i])[t](r),s=s.concat(r);return this.pushStack(s,e,o.selector)}}),v.extend({clone:function(e,t,n){var r,i,s,o;v.support.html5Clone||v.isXMLDoc(e)||!wt.test("<"+e.nodeName+">")?o=e.cloneNode(!0):(kt.innerHTML=e.outerHTML,kt.removeChild(o=kt.firstChild));if((!v.support.noCloneEvent||!v.support.noCloneChecked)&&(e.nodeType===1||e.nodeType===11)&&!v.isXMLDoc(e)){Ot(e,o),r=Mt(e),i=Mt(o);for(s=0;r[s];++s)i[s]&&Ot(r[s],i[s])}if(t){At(e,o);if(n){r=Mt(e),i=Mt(o);for(s=0;r[s];++s)At(r[s],i[s])}}return r=i=null,o},clean:function(e,t,n,r){var s,o,u,a,f,l,c,h,p,d,m,g,y=t===i&&Ct,b=[];if(!t||typeof t.createDocumentFragment=="undefined")t=i;for(s=0;(u=e[s])!=null;s++){typeof u=="number"&&(u+="");if(!u)continue;if(typeof u=="string")if(!gt.test(u))u=t.createTextNode(u);else{y=y||lt(t),c=t.createElement("div"),y.appendChild(c),u=u.replace(dt,"<$1>"),a=(vt.exec(u)||["",""])[1].toLowerCase(),f=Nt[a]||Nt._default,l=f[0],c.innerHTML=f[1]+u+f[2];while(l--)c=c.lastChild;if(!v.support.tbody){h=mt.test(u),p=a==="table"&&!h?c.firstChild&&c.firstChild.childNodes:f[1]===""&&!h?c.childNodes:[];for(o=p.length-1;o>=0;--o)v.nodeName(p[o],"tbody")&&!p[o].childNodes.length&&p[o].parentNode.removeChild(p[o])}!v.support.leadingWhitespace&&pt.test(u)&&c.insertBefore(t.createTextNode(pt.exec(u)[0]),c.firstChild),u=c.childNodes,c.parentNode.removeChild(c)}u.nodeType?b.push(u):v.merge(b,u)}c&&(u=c=y=null);if(!v.support.appendChecked)for(s=0;(u=b[s])!=null;s++)v.nodeName(u,"input")?_t(u):typeof u.getElementsByTagName!="undefined"&&v.grep(u.getElementsByTagName("input"),_t);if(n){m=function(e){if(!e.type||xt.test(e.type))return r?r.push(e.parentNode?e.parentNode.removeChild(e):e):n.appendChild(e)};for(s=0;(u=b[s])!=null;s++)if(!v.nodeName(u,"script")||!m(u))n.appendChild(u),typeof u.getElementsByTagName!="undefined"&&(g=v.grep(v.merge([],u.getElementsByTagName("script")),m),b.splice.apply(b,[s+1,0].concat(g)),s+=g.length)}return b},cleanData:function(e,t){var n,r,i,s,o=0,u=v.expando,a=v.cache,f=v.support.deleteExpando,l=v.event.special;for(;(i=e[o])!=null;o++)if(t||v.acceptData(i)){r=i[u],n=r&&a[r];if(n){if(n.events)for(s in n.events)l[s]?v.event.remove(i,s):v.removeEvent(i,s,n.handle);a[r]&&(delete a[r],f?delete i[u]:i.removeAttribute?i.removeAttribute(u):i[u]=null,v.deletedIds.push(r))}}}}),function(){var e,t;v.uaMatch=function(e){e=e.toLowerCase();var t=/(chrome)[ \/]([\w.]+)/.exec(e)||/(webkit)[ \/]([\w.]+)/.exec(e)||/(opera)(?:.*version|)[ \/]([\w.]+)/.exec(e)||/(msie) ([\w.]+)/.exec(e)||e.indexOf("compatible")<0&&/(mozilla)(?:.*? rv:([\w.]+)|)/.exec(e)||[];return{browser:t[1]||"",version:t[2]||"0"}},e=v.uaMatch(o.userAgent),t={},e.browser&&(t[e.browser]=!0,t.version=e.version),t.chrome?t.webkit=!0:t.webkit&&(t.safari=!0),v.browser=t,v.sub=function(){function e(t,n){return new e.fn.init(t,n)}v.extend(!0,e,this),e.superclass=this,e.fn=e.prototype=this(),e.fn.constructor=e,e.sub=this.sub,e.fn.init=function(r,i){return i&&i instanceof v&&!(i instanceof e)&&(i=e(i)),v.fn.init.call(this,r,i,t)},e.fn.init.prototype=e.fn;var t=e(i);return e}}();var Dt,Pt,Ht,Bt=/alpha\([^)]*\)/i,jt=/opacity=([^)]*)/,Ft=/^(top|right|bottom|left)$/,It=/^(none|table(?!-c[ea]).+)/,qt=/^margin/,Rt=new RegExp("^("+m+")(.*)$","i"),Ut=new RegExp("^("+m+")(?!px)[a-z%]+$","i"),zt=new RegExp("^([-+])=("+m+")","i"),Wt={BODY:"block"},Xt={position:"absolute",visibility:"hidden",display:"block"},Vt={letterSpacing:0,fontWeight:400},$t=["Top","Right","Bottom","Left"],Jt=["Webkit","O","Moz","ms"],Kt=v.fn.toggle;v.fn.extend({css:function(e,n){return v.access(this,function(e,n,r){return r!==t?v.style(e,n,r):v.css(e,n)},e,n,arguments.length>1)},show:function(){return Yt(this,!0)},hide:function(){return Yt(this)},toggle:function(e,t){var n=typeof e=="boolean";return v.isFunction(e)&&v.isFunction(t)?Kt.apply(this,arguments):this.each(function(){(n?e:Gt(this))?v(this).show():v(this).hide()})}}),v.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Dt(e,"opacity");return n===""?"1":n}}}},cssNumber:{fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":v.support.cssFloat?"cssFloat":"styleFloat"},style:function(e,n,r,i){if(!e||e.nodeType===3||e.nodeType===8||!e.style)return;var s,o,u,a=v.camelCase(n),f=e.style;n=v.cssProps[a]||(v.cssProps[a]=Qt(f,a)),u=v.cssHooks[n]||v.cssHooks[a];if(r===t)return u&&"get"in u&&(s=u.get(e,!1,i))!==t?s:f[n];o=typeof r,o==="string"&&(s=zt.exec(r))&&(r=(s[1]+1)*s[2]+parseFloat(v.css(e,n)),o="number");if(r==null||o==="number"&&isNaN(r))return;o==="number"&&!v.cssNumber[a]&&(r+="px");if(!u||!("set"in u)||(r=u.set(e,r,i))!==t)try{f[n]=r}catch(l){}},css:function(e,n,r,i){var s,o,u,a=v.camelCase(n);return n=v.cssProps[a]||(v.cssProps[a]=Qt(e.style,a)),u=v.cssHooks[n]||v.cssHooks[a],u&&"get"in u&&(s=u.get(e,!0,i)),s===t&&(s=Dt(e,n)),s==="normal"&&n in Vt&&(s=Vt[n]),r||i!==t?(o=parseFloat(s),r||v.isNumeric(o)?o||0:s):s},swap:function(e,t,n){var r,i,s={};for(i in t)s[i]=e.style[i],e.style[i]=t[i];r=n.call(e);for(i in t)e.style[i]=s[i];return r}}),e.getComputedStyle?Dt=function(t,n){var r,i,s,o,u=e.getComputedStyle(t,null),a=t.style;return u&&(r=u.getPropertyValue(n)||u[n],r===""&&!v.contains(t.ownerDocument,t)&&(r=v.style(t,n)),Ut.test(r)&&qt.test(n)&&(i=a.width,s=a.minWidth,o=a.maxWidth,a.minWidth=a.maxWidth=a.width=r,r=u.width,a.width=i,a.minWidth=s,a.maxWidth=o)),r}:i.documentElement.currentStyle&&(Dt=function(e,t){var n,r,i=e.currentStyle&&e.currentStyle[t],s=e.style;return i==null&&s&&s[t]&&(i=s[t]),Ut.test(i)&&!Ft.test(t)&&(n=s.left,r=e.runtimeStyle&&e.runtimeStyle.left,r&&(e.runtimeStyle.left=e.currentStyle.left),s.left=t==="fontSize"?"1em":i,i=s.pixelLeft+"px",s.left=n,r&&(e.runtimeStyle.left=r)),i===""?"auto":i}),v.each(["height","width"],function(e,t){v.cssHooks[t]={get:function(e,n,r){if(n)return e.offsetWidth===0&&It.test(Dt(e,"display"))?v.swap(e,Xt,function(){return tn(e,t,r)}):tn(e,t,r)},set:function(e,n,r){return Zt(e,n,r?en(e,t,r,v.support.boxSizing&&v.css(e,"boxSizing")==="border-box"):0)}}}),v.support.opacity||(v.cssHooks.opacity={get:function(e,t){return jt.test((t&&e.currentStyle?e.currentStyle.filter:e.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":t?"1":""},set:function(e,t){var n=e.style,r=e.currentStyle,i=v.isNumeric(t)?"alpha(opacity="+t*100+")":"",s=r&&r.filter||n.filter||"";n.zoom=1;if(t>=1&&v.trim(s.replace(Bt,""))===""&&n.removeAttribute){n.removeAttribute("filter");if(r&&!r.filter)return}n.filter=Bt.test(s)?s.replace(Bt,i):s+" "+i}}),v(function(){v.support.reliableMarginRight||(v.cssHooks.marginRight={get:function(e,t){return v.swap(e,{display:"inline-block"},function(){if(t)return Dt(e,"marginRight")})}}),!v.support.pixelPosition&&v.fn.position&&v.each(["top","left"],function(e,t){v.cssHooks[t]={get:function(e,n){if(n){var r=Dt(e,t);return Ut.test(r)?v(e).position()[t]+"px":r}}}})}),v.expr&&v.expr.filters&&(v.expr.filters.hidden=function(e){return e.offsetWidth===0&&e.offsetHeight===0||!v.support.reliableHiddenOffsets&&(e.style&&e.style.display||Dt(e,"display"))==="none"},v.expr.filters.visible=function(e){return!v.expr.filters.hidden(e)}),v.each({margin:"",padding:"",border:"Width"},function(e,t){v.cssHooks[e+t]={expand:function(n){var r,i=typeof n=="string"?n.split(" "):[n],s={};for(r=0;r<4;r++)s[e+$t[r]+t]=i[r]||i[r-2]||i[0];return s}},qt.test(e)||(v.cssHooks[e+t].set=Zt)});var rn=/%20/g,sn=/\[\]$/,on=/\r?\n/g,un=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,an=/^(?:select|textarea)/i;v.fn.extend({serialize:function(){return v.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?v.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||an.test(this.nodeName)||un.test(this.type))}).map(function(e,t){var n=v(this).val();return n==null?null:v.isArray(n)?v.map(n,function(e,n){return{name:t.name,value:e.replace(on,"\r\n")}}):{name:t.name,value:n.replace(on,"\r\n")}}).get()}}),v.param=function(e,n){var r,i=[],s=function(e,t){t=v.isFunction(t)?t():t==null?"":t,i[i.length]=encodeURIComponent(e)+"="+encodeURIComponent(t)};n===t&&(n=v.ajaxSettings&&v.ajaxSettings.traditional);if(v.isArray(e)||e.jquery&&!v.isPlainObject(e))v.each(e,function(){s(this.name,this.value)});else for(r in e)fn(r,e[r],n,s);return i.join("&").replace(rn,"+")};var ln,cn,hn=/#.*$/,pn=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,dn=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,vn=/^(?:GET|HEAD)$/,mn=/^\/\//,gn=/\?/,yn=/)<[^<]*)*<\/script>/gi,bn=/([?&])_=[^&]*/,wn=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/,En=v.fn.load,Sn={},xn={},Tn=["*/"]+["*"];try{cn=s.href}catch(Nn){cn=i.createElement("a"),cn.href="",cn=cn.href}ln=wn.exec(cn.toLowerCase())||[],v.fn.load=function(e,n,r){if(typeof e!="string"&&En)return En.apply(this,arguments);if(!this.length)return this;var i,s,o,u=this,a=e.indexOf(" ");return a>=0&&(i=e.slice(a,e.length),e=e.slice(0,a)),v.isFunction(n)?(r=n,n=t):n&&typeof n=="object"&&(s="POST"),v.ajax({url:e,type:s,dataType:"html",data:n,complete:function(e,t){r&&u.each(r,o||[e.responseText,t,e])}}).done(function(e){o=arguments,u.html(i?v("
").append(e.replace(yn,"")).find(i):e)}),this},v.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(e,t){v.fn[t]=function(e){return this.on(t,e)}}),v.each(["get","post"],function(e,n){v[n]=function(e,r,i,s){return v.isFunction(r)&&(s=s||i,i=r,r=t),v.ajax({type:n,url:e,data:r,success:i,dataType:s})}}),v.extend({getScript:function(e,n){return v.get(e,t,n,"script")},getJSON:function(e,t,n){return v.get(e,t,n,"json")},ajaxSetup:function(e,t){return t?Ln(e,v.ajaxSettings):(t=e,e=v.ajaxSettings),Ln(e,t),e},ajaxSettings:{url:cn,isLocal:dn.test(ln[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded; charset=UTF-8",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":Tn},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":e.String,"text html":!0,"text json":v.parseJSON,"text xml":v.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:Cn(Sn),ajaxTransport:Cn(xn),ajax:function(e,n){function T(e,n,s,a){var l,y,b,w,S,T=n;if(E===2)return;E=2,u&&clearTimeout(u),o=t,i=a||"",x.readyState=e>0?4:0,s&&(w=An(c,x,s));if(e>=200&&e<300||e===304)c.ifModified&&(S=x.getResponseHeader("Last-Modified"),S&&(v.lastModified[r]=S),S=x.getResponseHeader("Etag"),S&&(v.etag[r]=S)),e===304?(T="notmodified",l=!0):(l=On(c,w),T=l.state,y=l.data,b=l.error,l=!b);else{b=T;if(!T||e)T="error",e<0&&(e=0)}x.status=e,x.statusText=(n||T)+"",l?d.resolveWith(h,[y,T,x]):d.rejectWith(h,[x,T,b]),x.statusCode(g),g=t,f&&p.trigger("ajax"+(l?"Success":"Error"),[x,c,l?y:b]),m.fireWith(h,[x,T]),f&&(p.trigger("ajaxComplete",[x,c]),--v.active||v.event.trigger("ajaxStop"))}typeof e=="object"&&(n=e,e=t),n=n||{};var r,i,s,o,u,a,f,l,c=v.ajaxSetup({},n),h=c.context||c,p=h!==c&&(h.nodeType||h instanceof v)?v(h):v.event,d=v.Deferred(),m=v.Callbacks("once memory"),g=c.statusCode||{},b={},w={},E=0,S="canceled",x={readyState:0,setRequestHeader:function(e,t){if(!E){var n=e.toLowerCase();e=w[n]=w[n]||e,b[e]=t}return this},getAllResponseHeaders:function(){return E===2?i:null},getResponseHeader:function(e){var n;if(E===2){if(!s){s={};while(n=pn.exec(i))s[n[1].toLowerCase()]=n[2]}n=s[e.toLowerCase()]}return n===t?null:n},overrideMimeType:function(e){return E||(c.mimeType=e),this},abort:function(e){return e=e||S,o&&o.abort(e),T(0,e),this}};d.promise(x),x.success=x.done,x.error=x.fail,x.complete=m.add,x.statusCode=function(e){if(e){var t;if(E<2)for(t in e)g[t]=[g[t],e[t]];else t=e[x.status],x.always(t)}return this},c.url=((e||c.url)+"").replace(hn,"").replace(mn,ln[1]+"//"),c.dataTypes=v.trim(c.dataType||"*").toLowerCase().split(y),c.crossDomain==null&&(a=wn.exec(c.url.toLowerCase()),c.crossDomain=!(!a||a[1]===ln[1]&&a[2]===ln[2]&&(a[3]||(a[1]==="http:"?80:443))==(ln[3]||(ln[1]==="http:"?80:443)))),c.data&&c.processData&&typeof c.data!="string"&&(c.data=v.param(c.data,c.traditional)),kn(Sn,c,n,x);if(E===2)return x;f=c.global,c.type=c.type.toUpperCase(),c.hasContent=!vn.test(c.type),f&&v.active++===0&&v.event.trigger("ajaxStart");if(!c.hasContent){c.data&&(c.url+=(gn.test(c.url)?"&":"?")+c.data,delete c.data),r=c.url;if(c.cache===!1){var N=v.now(),C=c.url.replace(bn,"$1_="+N);c.url=C+(C===c.url?(gn.test(c.url)?"&":"?")+"_="+N:"")}}(c.data&&c.hasContent&&c.contentType!==!1||n.contentType)&&x.setRequestHeader("Content-Type",c.contentType),c.ifModified&&(r=r||c.url,v.lastModified[r]&&x.setRequestHeader("If-Modified-Since",v.lastModified[r]),v.etag[r]&&x.setRequestHeader("If-None-Match",v.etag[r])),x.setRequestHeader("Accept",c.dataTypes[0]&&c.accepts[c.dataTypes[0]]?c.accepts[c.dataTypes[0]]+(c.dataTypes[0]!=="*"?", "+Tn+"; q=0.01":""):c.accepts["*"]);for(l in c.headers)x.setRequestHeader(l,c.headers[l]);if(!c.beforeSend||c.beforeSend.call(h,x,c)!==!1&&E!==2){S="abort";for(l in{success:1,error:1,complete:1})x[l](c[l]);o=kn(xn,c,n,x);if(!o)T(-1,"No Transport");else{x.readyState=1,f&&p.trigger("ajaxSend",[x,c]),c.async&&c.timeout>0&&(u=setTimeout(function(){x.abort("timeout")},c.timeout));try{E=1,o.send(b,T)}catch(k){if(!(E<2))throw k;T(-1,k)}}return x}return x.abort()},active:0,lastModified:{},etag:{}});var Mn=[],_n=/\?/,Dn=/(=)\?(?=&|$)|\?\?/,Pn=v.now();v.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Mn.pop()||v.expando+"_"+Pn++;return this[e]=!0,e}}),v.ajaxPrefilter("json jsonp",function(n,r,i){var s,o,u,a=n.data,f=n.url,l=n.jsonp!==!1,c=l&&Dn.test(f),h=l&&!c&&typeof a=="string"&&!(n.contentType||"").indexOf("application/x-www-form-urlencoded")&&Dn.test(a);if(n.dataTypes[0]==="jsonp"||c||h)return s=n.jsonpCallback=v.isFunction(n.jsonpCallback)?n.jsonpCallback():n.jsonpCallback,o=e[s],c?n.url=f.replace(Dn,"$1"+s):h?n.data=a.replace(Dn,"$1"+s):l&&(n.url+=(_n.test(f)?"&":"?")+n.jsonp+"="+s),n.converters["script json"]=function(){return u||v.error(s+" was not called"),u[0]},n.dataTypes[0]="json",e[s]=function(){u=arguments},i.always(function(){e[s]=o,n[s]&&(n.jsonpCallback=r.jsonpCallback,Mn.push(s)),u&&v.isFunction(o)&&o(u[0]),u=o=t}),"script"}),v.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(e){return v.globalEval(e),e}}}),v.ajaxPrefilter("script",function(e){e.cache===t&&(e.cache=!1),e.crossDomain&&(e.type="GET",e.global=!1)}),v.ajaxTransport("script",function(e){if(e.crossDomain){var n,r=i.head||i.getElementsByTagName("head")[0]||i.documentElement;return{send:function(s,o){n=i.createElement("script"),n.async="async",e.scriptCharset&&(n.charset=e.scriptCharset),n.src=e.url,n.onload=n.onreadystatechange=function(e,i){if(i||!n.readyState||/loaded|complete/.test(n.readyState))n.onload=n.onreadystatechange=null,r&&n.parentNode&&r.removeChild(n),n=t,i||o(200,"success")},r.insertBefore(n,r.firstChild)},abort:function(){n&&n.onload(0,1)}}}});var Hn,Bn=e.ActiveXObject?function(){for(var e in Hn)Hn[e](0,1)}:!1,jn=0;v.ajaxSettings.xhr=e.ActiveXObject?function(){return!this.isLocal&&Fn()||In()}:Fn,function(e){v.extend(v.support,{ajax:!!e,cors:!!e&&"withCredentials"in e})}(v.ajaxSettings.xhr()),v.support.ajax&&v.ajaxTransport(function(n){if(!n.crossDomain||v.support.cors){var r;return{send:function(i,s){var o,u,a=n.xhr();n.username?a.open(n.type,n.url,n.async,n.username,n.password):a.open(n.type,n.url,n.async);if(n.xhrFields)for(u in n.xhrFields)a[u]=n.xhrFields[u];n.mimeType&&a.overrideMimeType&&a.overrideMimeType(n.mimeType),!n.crossDomain&&!i["X-Requested-With"]&&(i["X-Requested-With"]="XMLHttpRequest");try{for(u in i)a.setRequestHeader(u,i[u])}catch(f){}a.send(n.hasContent&&n.data||null),r=function(e,i){var u,f,l,c,h;try{if(r&&(i||a.readyState===4)){r=t,o&&(a.onreadystatechange=v.noop,Bn&&delete Hn[o]);if(i)a.readyState!==4&&a.abort();else{u=a.status,l=a.getAllResponseHeaders(),c={},h=a.responseXML,h&&h.documentElement&&(c.xml=h);try{c.text=a.responseText}catch(p){}try{f=a.statusText}catch(p){f=""}!u&&n.isLocal&&!n.crossDomain?u=c.text?200:404:u===1223&&(u=204)}}}catch(d){i||s(-1,d)}c&&s(u,f,c,l)},n.async?a.readyState===4?setTimeout(r,0):(o=++jn,Bn&&(Hn||(Hn={},v(e).unload(Bn)),Hn[o]=r),a.onreadystatechange=r):r()},abort:function(){r&&r(0,1)}}}});var qn,Rn,Un=/^(?:toggle|show|hide)$/,zn=new RegExp("^(?:([-+])=|)("+m+")([a-z%]*)$","i"),Wn=/queueHooks$/,Xn=[Gn],Vn={"*":[function(e,t){var n,r,i=this.createTween(e,t),s=zn.exec(t),o=i.cur(),u=+o||0,a=1,f=20;if(s){n=+s[2],r=s[3]||(v.cssNumber[e]?"":"px");if(r!=="px"&&u){u=v.css(i.elem,e,!0)||n||1;do a=a||".5",u/=a,v.style(i.elem,e,u+r);while(a!==(a=i.cur()/o)&&a!==1&&--f)}i.unit=r,i.start=u,i.end=s[1]?u+(s[1]+1)*n:n}return i}]};v.Animation=v.extend(Kn,{tweener:function(e,t){v.isFunction(e)?(t=e,e=["*"]):e=e.split(" ");var n,r=0,i=e.length;for(;r-1,f={},l={},c,h;a?(l=i.position(),c=l.top,h=l.left):(c=parseFloat(o)||0,h=parseFloat(u)||0),v.isFunction(t)&&(t=t.call(e,n,s)),t.top!=null&&(f.top=t.top-s.top+c),t.left!=null&&(f.left=t.left-s.left+h),"using"in t?t.using.call(e,f):i.css(f)}},v.fn.extend({position:function(){if(!this[0])return;var e=this[0],t=this.offsetParent(),n=this.offset(),r=er.test(t[0].nodeName)?{top:0,left:0}:t.offset();return n.top-=parseFloat(v.css(e,"marginTop"))||0,n.left-=parseFloat(v.css(e,"marginLeft"))||0,r.top+=parseFloat(v.css(t[0],"borderTopWidth"))||0,r.left+=parseFloat(v.css(t[0],"borderLeftWidth"))||0,{top:n.top-r.top,left:n.left-r.left}},offsetParent:function(){return this.map(function(){var e=this.offsetParent||i.body;while(e&&!er.test(e.nodeName)&&v.css(e,"position")==="static")e=e.offsetParent;return e||i.body})}}),v.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,n){var r=/Y/.test(n);v.fn[e]=function(i){return v.access(this,function(e,i,s){var o=tr(e);if(s===t)return o?n in o?o[n]:o.document.documentElement[i]:e[i];o?o.scrollTo(r?v(o).scrollLeft():s,r?s:v(o).scrollTop()):e[i]=s},e,i,arguments.length,null)}}),v.each({Height:"height",Width:"width"},function(e,n){v.each({padding:"inner"+e,content:n,"":"outer"+e},function(r,i){v.fn[i]=function(i,s){var o=arguments.length&&(r||typeof i!="boolean"),u=r||(i===!0||s===!0?"margin":"border");return v.access(this,function(n,r,i){var s;return v.isWindow(n)?n.document.documentElement["client"+e]:n.nodeType===9?(s=n.documentElement,Math.max(n.body["scroll"+e],s["scroll"+e],n.body["offset"+e],s["offset"+e],s["client"+e])):i===t?v.css(n,r,i,u):v.style(n,r,i,u)},n,o?i:t,o,null)}})}),e.jQuery=e.$=v,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return v})})(window); \ No newline at end of file diff --git a/doc/build/html/_static/minus.png b/doc/build/html/_static/minus.png new file mode 100644 index 0000000..da1c562 Binary files /dev/null and b/doc/build/html/_static/minus.png differ diff --git a/doc/build/html/_static/plus.png b/doc/build/html/_static/plus.png new file mode 100644 index 0000000..b3cb374 Binary files /dev/null and b/doc/build/html/_static/plus.png differ diff --git a/doc/build/html/_static/pygments.css b/doc/build/html/_static/pygments.css new file mode 100644 index 0000000..d79caa1 --- /dev/null +++ b/doc/build/html/_static/pygments.css @@ -0,0 +1,62 @@ +.highlight .hll { background-color: #ffffcc } +.highlight { background: #eeffcc; } +.highlight .c { color: #408090; font-style: italic } /* Comment */ +.highlight .err { border: 1px solid #FF0000 } /* Error */ +.highlight .k { color: #007020; font-weight: bold } /* Keyword */ +.highlight .o { color: #666666 } /* Operator */ +.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #007020 } /* Comment.Preproc */ +.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */ +.highlight .gd { color: #A00000 } /* Generic.Deleted */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #FF0000 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #00A000 } /* Generic.Inserted */ +.highlight .go { color: #333333 } /* Generic.Output */ +.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #0044DD } /* Generic.Traceback */ +.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #007020 } /* Keyword.Pseudo */ +.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #902000 } /* Keyword.Type */ +.highlight .m { color: #208050 } /* Literal.Number */ +.highlight .s { color: #4070a0 } /* Literal.String */ +.highlight .na { color: #4070a0 } /* Name.Attribute */ +.highlight .nb { color: #007020 } /* Name.Builtin */ +.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ +.highlight .no { color: #60add5 } /* Name.Constant */ +.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ +.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ +.highlight .ne { color: #007020 } /* Name.Exception */ +.highlight .nf { color: #06287e } /* Name.Function */ +.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ +.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ +.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #bb60d5 } /* Name.Variable */ +.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mf { color: #208050 } /* Literal.Number.Float */ +.highlight .mh { color: #208050 } /* Literal.Number.Hex */ +.highlight .mi { color: #208050 } /* Literal.Number.Integer */ +.highlight .mo { color: #208050 } /* Literal.Number.Oct */ +.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ +.highlight .sc { color: #4070a0 } /* Literal.String.Char */ +.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #4070a0 } /* Literal.String.Double */ +.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ +.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ +.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ +.highlight .sx { color: #c65d09 } /* Literal.String.Other */ +.highlight .sr { color: #235388 } /* Literal.String.Regex */ +.highlight .s1 { color: #4070a0 } /* Literal.String.Single */ +.highlight .ss { color: #517918 } /* Literal.String.Symbol */ +.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ +.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ +.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ +.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/doc/build/html/_static/searchtools.js b/doc/build/html/_static/searchtools.js new file mode 100644 index 0000000..cbafbed --- /dev/null +++ b/doc/build/html/_static/searchtools.js @@ -0,0 +1,622 @@ +/* + * searchtools.js_t + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilties for the full-text search. + * + * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + + +/** + * Porter Stemmer + */ +var Stemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + + + +/** + * Simple result scoring code. + */ +var Scorer = { + // Implement the following function to further tweak the score for each result + // The function takes a result array [filename, title, anchor, descr, score] + // and returns the new score. + /* + score: function(result) { + return result[4]; + }, + */ + + // query matches the full name of an object + objNameMatch: 11, + // or matches in the last dotted part of the object name + objPartialMatch: 6, + // Additive scores depending on the priority of the object + objPrio: {0: 15, // used to be importantResults + 1: 5, // used to be objectResults + 2: -5}, // used to be unimportantResults + // Used when the priority is not in the mapping. + objPrioDefault: 0, + + // query found in title + title: 15, + // query found in terms + term: 5 +}; + + +/** + * Search Module + */ +var Search = { + + _index : null, + _queued_query : null, + _pulse_status : -1, + + init : function() { + var params = $.getQueryParameters(); + if (params.q) { + var query = params.q[0]; + $('input[name="q"]')[0].value = query; + this.performSearch(query); + } + }, + + loadIndex : function(url) { + $.ajax({type: "GET", url: url, data: null, + dataType: "script", cache: true, + complete: function(jqxhr, textstatus) { + if (textstatus != "success") { + document.getElementById("searchindexloader").src = url; + } + }}); + }, + + setIndex : function(index) { + var q; + this._index = index; + if ((q = this._queued_query) !== null) { + this._queued_query = null; + Search.query(q); + } + }, + + hasIndex : function() { + return this._index !== null; + }, + + deferQuery : function(query) { + this._queued_query = query; + }, + + stopPulse : function() { + this._pulse_status = 0; + }, + + startPulse : function() { + if (this._pulse_status >= 0) + return; + function pulse() { + var i; + Search._pulse_status = (Search._pulse_status + 1) % 4; + var dotString = ''; + for (i = 0; i < Search._pulse_status; i++) + dotString += '.'; + Search.dots.text(dotString); + if (Search._pulse_status > -1) + window.setTimeout(pulse, 500); + } + pulse(); + }, + + /** + * perform a search for something (or wait until index is loaded) + */ + performSearch : function(query) { + // create the required interface elements + this.out = $('#search-results'); + this.title = $('

' + _('Searching') + '

').appendTo(this.out); + this.dots = $('').appendTo(this.title); + this.status = $('

').appendTo(this.out); + this.output = $('
'); + } + // Prettify the comment rating. + comment.pretty_rating = comment.rating + ' point' + + (comment.rating == 1 ? '' : 's'); + // Make a class (for displaying not yet moderated comments differently) + comment.css_class = comment.displayed ? '' : ' moderate'; + // Create a div for this comment. + var context = $.extend({}, opts, comment); + var div = $(renderTemplate(commentTemplate, context)); + + // If the user has voted on this comment, highlight the correct arrow. + if (comment.vote) { + var direction = (comment.vote == 1) ? 'u' : 'd'; + div.find('#' + direction + 'v' + comment.id).hide(); + div.find('#' + direction + 'u' + comment.id).show(); + } + + if (opts.moderator || comment.text != '[deleted]') { + div.find('a.reply').show(); + if (comment.proposal_diff) + div.find('#sp' + comment.id).show(); + if (opts.moderator && !comment.displayed) + div.find('#cm' + comment.id).show(); + if (opts.moderator || (opts.username == comment.username)) + div.find('#dc' + comment.id).show(); + } + return div; + } + + /** + * A simple template renderer. Placeholders such as <%id%> are replaced + * by context['id'] with items being escaped. Placeholders such as <#id#> + * are not escaped. + */ + function renderTemplate(template, context) { + var esc = $(document.createElement('div')); + + function handle(ph, escape) { + var cur = context; + $.each(ph.split('.'), function() { + cur = cur[this]; + }); + return escape ? esc.text(cur || "").html() : cur; + } + + return template.replace(/<([%#])([\w\.]*)\1>/g, function() { + return handle(arguments[2], arguments[1] == '%' ? true : false); + }); + } + + /** Flash an error message briefly. */ + function showError(message) { + $(document.createElement('div')).attr({'class': 'popup-error'}) + .append($(document.createElement('div')) + .attr({'class': 'error-message'}).text(message)) + .appendTo('body') + .fadeIn("slow") + .delay(2000) + .fadeOut("slow"); + } + + /** Add a link the user uses to open the comments popup. */ + $.fn.comment = function() { + return this.each(function() { + var id = $(this).attr('id').substring(1); + var count = COMMENT_METADATA[id]; + var title = count + ' comment' + (count == 1 ? '' : 's'); + var image = count > 0 ? opts.commentBrightImage : opts.commentImage; + var addcls = count == 0 ? ' nocomment' : ''; + $(this) + .append( + $(document.createElement('a')).attr({ + href: '#', + 'class': 'sphinx-comment-open' + addcls, + id: 'ao' + id + }) + .append($(document.createElement('img')).attr({ + src: image, + alt: 'comment', + title: title + })) + .click(function(event) { + event.preventDefault(); + show($(this).attr('id').substring(2)); + }) + ) + .append( + $(document.createElement('a')).attr({ + href: '#', + 'class': 'sphinx-comment-close hidden', + id: 'ah' + id + }) + .append($(document.createElement('img')).attr({ + src: opts.closeCommentImage, + alt: 'close', + title: 'close' + })) + .click(function(event) { + event.preventDefault(); + hide($(this).attr('id').substring(2)); + }) + ); + }); + }; + + var opts = { + processVoteURL: '/_process_vote', + addCommentURL: '/_add_comment', + getCommentsURL: '/_get_comments', + acceptCommentURL: '/_accept_comment', + deleteCommentURL: '/_delete_comment', + commentImage: '/static/_static/comment.png', + closeCommentImage: '/static/_static/comment-close.png', + loadingImage: '/static/_static/ajax-loader.gif', + commentBrightImage: '/static/_static/comment-bright.png', + upArrow: '/static/_static/up.png', + downArrow: '/static/_static/down.png', + upArrowPressed: '/static/_static/up-pressed.png', + downArrowPressed: '/static/_static/down-pressed.png', + voting: false, + moderator: false + }; + + if (typeof COMMENT_OPTIONS != "undefined") { + opts = jQuery.extend(opts, COMMENT_OPTIONS); + } + + var popupTemplate = '\ +
\ +

\ + Sort by:\ + best rated\ + newest\ + oldest\ +

\ +
Comments
\ +
\ + loading comments...
\ +
    \ +
    \ +

    Add a comment\ + (markup):

    \ +
    \ + reStructured text markup: *emph*, **strong**, \ + ``code``, \ + code blocks: :: and an indented block after blank line
    \ +
    \ + \ +

    \ + \ + Propose a change ▹\ + \ + \ + Propose a change ▿\ + \ +

    \ + \ + \ + \ + \ + \ +
    \ +
    '; + + var commentTemplate = '\ +
    \ +
    \ +
    \ + \ + \ + \ + \ + \ + \ +
    \ +
    \ + \ + \ + \ + \ + \ + \ +
    \ +
    \ +
    \ +

    \ + <%username%>\ + <%pretty_rating%>\ + <%time.delta%>\ +

    \ +
    <#text#>
    \ +

    \ + \ + reply ▿\ + proposal ▹\ + proposal ▿\ + \ + \ +

    \ +
    \
    +<#proposal_diff#>\
    +        
    \ +
      \ +
      \ +
      \ +
      \ + '; + + var replyTemplate = '\ +
    • \ +
      \ +
      \ + \ + \ + \ + \ + \ + \ +
      \ +
    • '; + + $(document).ready(function() { + init(); + }); +})(jQuery); + +$(document).ready(function() { + // add comment anchors for all paragraphs that are commentable + $('.sphinx-has-comment').comment(); + + // highlight search words in search results + $("div.context").each(function() { + var params = $.getQueryParameters(); + var terms = (params.q) ? params.q[0].split(/\s+/) : []; + var result = $(this); + $.each(terms, function() { + result.highlightText(this.toLowerCase(), 'highlighted'); + }); + }); + + // directly open comment window if requested + var anchor = document.location.hash; + if (anchor.substring(0, 9) == '#comment-') { + $('#ao' + anchor.substring(9)).click(); + document.location.hash = '#s' + anchor.substring(9); + } +}); diff --git a/doc/build/html/api/accounting.html b/doc/build/html/api/accounting.html new file mode 100644 index 0000000..00dc3e8 --- /dev/null +++ b/doc/build/html/api/accounting.html @@ -0,0 +1,426 @@ + + + + + + + + accounting package — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + + +
      +
      +
      +
      + +
      +

      accounting package

      + +
      +

      Submodules

      +
      +
      +

      accounting.client module

      +
      +
      +class accounting.client.Client(host=None, json_encoder=None, json_decoder=None)[source]
      +

      Bases: builtins.object

      +
      +
      +get(path)[source]
      +
      + +
      +
      +get_balance()[source]
      +
      + +
      +
      +get_register()[source]
      +
      + +
      +
      +post(path, payload, **kw)[source]
      +
      + +
      +
      +simple_transaction(from_acc, to_acc, amount, symbol=None, payee=None)[source]
      +
      + +
      + +
      +
      +accounting.client.main(argv=None, prog=None)[source]
      +
      + +
      +
      +accounting.client.print_balance_accounts(accounts, level=0)[source]
      +
      + +
      +
      +accounting.client.print_transactions(transactions)[source]
      +
      + +
      +
      +

      accounting.config module

      +
      +
      +

      accounting.decorators module

      +
      +
      +accounting.decorators.jsonify_exceptions(func)[source]
      +

      Wraps a Flask endpoint and catches any AccountingException-based +exceptions which are returned to the client as JSON.

      +
      + +
      +
      +

      accounting.exceptions module

      +
      +
      +exception accounting.exceptions.AccountingException[source]
      +

      Bases: builtins.Exception

      +

      Used as a base for exceptions that are returned to the caller via the +jsonify_exceptions decorator

      +
      + +
      +
      +

      accounting.gtkclient module

      +
      +
      +class accounting.gtkclient.AccountingApplication[source]
      +

      Bases: builtins.object

      +
      +
      +load_ui(path)[source]
      +
      + +
      +
      +on_aboutdialog_close(widget)[source]
      +
      + +
      +
      +on_refresh_transactions_activate(widget)[source]
      +
      + +
      +
      +on_show_about_activate(widget)[source]
      +
      + +
      +
      +on_transaction_selected(widget)[source]
      +
      + +
      +
      +on_transactions_loaded(transactions)[source]
      +
      + +
      + +
      +
      +accounting.gtkclient.indicate_activity(func_or_str)[source]
      +
      + +
      +
      +accounting.gtkclient.indicate_activity_done(func)[source]
      +
      + +
      +
      +accounting.gtkclient.main(argv=None)[source]
      +
      + +
      +
      +

      accounting.models module

      +
      +
      +class accounting.models.Account(name=None, amounts=None, accounts=None)[source]
      +

      Bases: builtins.object

      +
      + +
      +
      +class accounting.models.Amount(amount=None, symbol=None)[source]
      +

      Bases: builtins.object

      +
      + +
      +
      +class accounting.models.Posting(account=None, amount=None, metadata=None)[source]
      +

      Bases: builtins.object

      +
      + +
      +
      +class accounting.models.Transaction(id=None, date=None, payee=None, postings=None, metadata=None, _generate_id=False)[source]
      +

      Bases: builtins.object

      +
      +
      +generate_id()[source]
      +
      + +
      + +
      +
      +

      accounting.transport module

      +
      +
      +class accounting.transport.AccountingDecoder[source]
      +

      Bases: flask.json.JSONDecoder

      +
      +
      +dict_to_object(d)[source]
      +
      + +
      + +
      +
      +class accounting.transport.AccountingEncoder(skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, sort_keys=False, indent=None, separators=None, default=None)[source]
      +

      Bases: flask.json.JSONEncoder

      +
      +
      +default(o)[source]
      +
      + +
      + +
      +
      +

      accounting.web module

      +

      This module contains the high-level webservice logic such as the Flask setup +and the Flask endpoints.

      +
      +
      +accounting.web.index()[source]
      +

      Hello World!

      +
      + +
      +
      +accounting.web.init_ledger()[source]
      +

      flask.Flask.before_request()-decorated method that initializes an +accounting.Ledger object.

      +
      + +
      +
      +accounting.web.main(argv=None)[source]
      +
      + +
      +
      +accounting.web.transaction_get()[source]
      +

      Returns the JSON-serialized output of accounting.Ledger.reg()

      +
      + +
      +
      +accounting.web.transaction_post()[source]
      +

      REST/JSON endpoint for transactions.

      +

      Current state:

      +

      Takes a POST request with a transactions JSON payload and writes it to +the ledger file.

      +

      Requires the transactions payload to be __type__-annotated:

      +
      {
      +  "transactions": [
      +    {
      +      "__type__": "Transaction",
      +      "date": "2013-01-01",
      +      "payee": "Kindly T. Donor",
      +      "postings": [
      +        {
      +          "__type__": "Posting",
      +          "account": "Income:Foo:Donation",
      +          "amount": {
      +            "__type__": "Amount",
      +            "amount": "-100",
      +            "symbol": "$"
      +          }
      +        },
      +        {
      +          "__type__": "Posting",
      +          "account": "Assets:Checking",
      +          "amount": {
      +            "__type__": "Amount",
      +            "amount": "100",
      +            "symbol": "$"
      +          }
      +        }
      +      ]
      +    }
      +}
      +
      +

      becomes:

      +
      2013-01-01 Kindly T. Donor
      +  Income:Foo:Donation                                         $ -100
      +  Assets:Checking                                              $ 100
      +
      +
      + +
      +
      +accounting.web.transaction_update(transaction_id=None)
      +
      + +
      +
      +

      Module contents

      +
      +
      + + +
      +
      +
      + +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/api/accounting.storage.html b/doc/build/html/api/accounting.storage.html new file mode 100644 index 0000000..1519960 --- /dev/null +++ b/doc/build/html/api/accounting.storage.html @@ -0,0 +1,284 @@ + + + + + + + + accounting.storage package — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + + + +
      +
      +
      +
      + +
      +

      accounting.storage package

      + +
      +

      Submodules

      +
      +
      +

      accounting.storage.ledgercli module

      +
      +
      +class accounting.storage.ledgercli.Ledger(app=None, ledger_file=None, ledger_bin=None)[source]
      +

      Bases: accounting.storage.Storage

      +
      +
      +add_transaction(transaction)[source]
      +

      Writes a transaction to the ledger file by opening it in ‘ab’ mode and +writing a ledger transaction based on the +Transaction instance in +transaction.

      +
      + +
      +
      +assemble_arguments()[source]
      +

      Returns a list of arguments suitable for subprocess.Popen +based on self.ledger_bin and self.ledger_file.

      +
      + +
      +
      +bal()[source]
      +
      + +
      +
      +get_process()[source]
      +

      Returns self.ledger_process if it evaluates to True. If +self.ledger_process is not set the result of +self.init_process() is returned.

      +
      + +
      +
      +get_transactions()[source]
      +
      + +
      +
      +init_process()[source]
      +

      Creates a new (presumably) ledger subprocess based on the args from +Ledger.assemble_arguments() and then runs +Ledger.read_until_prompt() once (which should return the banner +text) and discards the output.

      +
      + +
      +
      +locked_process()[source]
      +

      Context manager that checks that the ledger process is not already +locked, then “locks” the process and yields the process handle and +unlocks the process when execution is returned.

      +

      Since this decorated as a contextlib.contextmanager() the +recommended use is with the with-statement.

      +
      with self.locked_process() as p:
      +    p.stdin.write(b'bal\n')
      +
      +    output = self.read_until_prompt(p)
      +
      +
      +
      + +
      +
      +read_until_prompt(process)[source]
      +

      Reads from the subprocess instance process until it finds a +combination of \n]\x20 (the prompt), then returns the output +without the prompt.

      +
      + +
      +
      +reg()[source]
      +
      + +
      +
      +send_command(command)[source]
      +
      + +
      +
      +update_transaction(transaction)[source]
      +
      + +
      + +
      +
      +accounting.storage.ledgercli.main(argv=None)[source]
      +
      + +
      +
      +

      Module contents

      +
      +
      +class accounting.storage.Storage(*args, **kw)[source]
      +

      Bases: builtins.object

      +

      ABC for accounting storage

      +
      +
      +get_account(*args, **kw)[source]
      +
      + +
      +
      +get_accounts(*args, **kw)[source]
      +
      + +
      +
      +get_transaction(*args, **kw)[source]
      +
      + +
      +
      +get_transactions(*args, **kw)[source]
      +
      + +
      +
      +reverse_transaction(transaction_id)
      +
      + +
      +
      +update_transaction(transaction)
      +
      + +
      + +
      +
      + + +
      +
      +
      +
      +
      +

      Table Of Contents

      + + +

      Previous topic

      +

      accounting package

      +

      Next topic

      +

      accounting.storage.sql package

      +

      This Page

      + + + +
      +
      +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/api/accounting.storage.sql.html b/doc/build/html/api/accounting.storage.sql.html new file mode 100644 index 0000000..d96adf9 --- /dev/null +++ b/doc/build/html/api/accounting.storage.sql.html @@ -0,0 +1,259 @@ + + + + + + + + accounting.storage.sql package — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + + +
      +
      +
      +
      + +
      +

      accounting.storage.sql package

      +
      +

      Submodules

      +
      +
      +

      accounting.storage.sql.models module

      +
      +
      +class accounting.storage.sql.models.Amount(**kwargs)[source]
      +

      Bases: flask_sqlalchemy.Model

      +
      +
      +amount
      +
      + +
      +
      +as_dict()[source]
      +
      + +
      +
      +id
      +
      + +
      +
      +symbol
      +
      + +
      + +
      +
      +class accounting.storage.sql.models.Posting(**kwargs)[source]
      +

      Bases: flask_sqlalchemy.Model

      +
      +
      +account
      +
      + +
      +
      +amount
      +
      + +
      +
      +amount_id
      +
      + +
      +
      +as_dict()[source]
      +
      + +
      +
      +id
      +
      + +
      +
      +meta
      +
      + +
      +
      +transaction
      +
      + +
      +
      +transaction_uuid
      +
      + +
      + +
      +
      +class accounting.storage.sql.models.Transaction(**kwargs)[source]
      +

      Bases: flask_sqlalchemy.Model

      +
      +
      +as_dict()[source]
      +
      + +
      +
      +date
      +
      + +
      +
      +id
      +
      + +
      +
      +meta
      +
      + +
      +
      +payee
      +
      + +
      +
      +uuid
      +
      + +
      + +
      +
      +

      Module contents

      +
      +
      +class accounting.storage.sql.SQLStorage(app=None)[source]
      +

      Bases: accounting.storage.Storage

      +
      +
      +add_transaction(transaction)[source]
      +
      + +
      +
      +get_transactions(*args, **kw)[source]
      +
      + +
      +
      +update_transaction(transaction)[source]
      +
      + +
      + +
      +
      + + +
      +
      +
      +
      +
      +

      Table Of Contents

      + + +

      Previous topic

      +

      accounting.storage package

      +

      This Page

      + + + +
      +
      +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/api/asyncio-test.html b/doc/build/html/api/asyncio-test.html new file mode 100644 index 0000000..5590f3a --- /dev/null +++ b/doc/build/html/api/asyncio-test.html @@ -0,0 +1,96 @@ + + + + + + + + asyncio-test Module — Accounting API 0.1-beta documentation + + + + + + + + + + + + + +
      +
      +
      +
      + +
      +

      asyncio-test Module

      +
      + + +
      +
      +
      +
      +
      +

      This Page

      + + + +
      +
      +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/api/modules.html b/doc/build/html/api/modules.html new file mode 100644 index 0000000..54a8c1b --- /dev/null +++ b/doc/build/html/api/modules.html @@ -0,0 +1,123 @@ + + + + + + + + accounting — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/doc/build/html/genindex.html b/doc/build/html/genindex.html new file mode 100644 index 0000000..a152c27 --- /dev/null +++ b/doc/build/html/genindex.html @@ -0,0 +1,625 @@ + + + + + + + + + Index — Accounting API 0.1-beta documentation + + + + + + + + + + + + + +
      +
      +
      +
      + + +

      Index

      + +
      + A + | B + | C + | D + | G + | I + | J + | L + | M + | O + | P + | R + | S + | T + | U + +
      +

      A

      +
      + + +
      + +
      account (accounting.storage.sql.models.Posting attribute) +
      + + +
      Account (class in accounting.models) +
      + + +
      accounting (module) +
      + + +
      accounting.client (module) +
      + + +
      accounting.config (module) +
      + + +
      accounting.decorators (module) +
      + + +
      accounting.exceptions (module) +
      + + +
      accounting.gtkclient (module) +
      + + +
      accounting.models (module) +
      + + +
      accounting.storage (module) +
      + + +
      accounting.storage.ledgercli (module) +
      + + +
      accounting.storage.sql (module) +
      + + +
      accounting.storage.sql.models (module) +
      + +
      + +
      accounting.transport (module) +
      + + +
      accounting.web (module) +
      + + +
      AccountingApplication (class in accounting.gtkclient) +
      + + +
      AccountingDecoder (class in accounting.transport) +
      + + +
      AccountingEncoder (class in accounting.transport) +
      + + +
      AccountingException +
      + + +
      add_transaction() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +
      (accounting.storage.sql.SQLStorage method) +
      + +
      + +
      amount (accounting.storage.sql.models.Amount attribute) +
      + +
      + +
      (accounting.storage.sql.models.Posting attribute) +
      + +
      + +
      Amount (class in accounting.models) +
      + +
      + +
      (class in accounting.storage.sql.models) +
      + +
      + +
      amount_id (accounting.storage.sql.models.Posting attribute) +
      + + +
      as_dict() (accounting.storage.sql.models.Amount method) +
      + +
      + +
      (accounting.storage.sql.models.Posting method) +
      + + +
      (accounting.storage.sql.models.Transaction method) +
      + +
      + +
      assemble_arguments() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +

      B

      + + +
      + +
      bal() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +

      C

      + + +
      + +
      Client (class in accounting.client) +
      + +
      + +

      D

      + + + +
      + +
      date (accounting.storage.sql.models.Transaction attribute) +
      + + +
      default() (accounting.transport.AccountingEncoder method) +
      + +
      + +
      dict_to_object() (accounting.transport.AccountingDecoder method) +
      + +
      + +

      G

      + + + +
      + +
      generate_id() (accounting.models.Transaction method) +
      + + +
      get() (accounting.client.Client method) +
      + + +
      get_account() (accounting.storage.Storage method) +
      + + +
      get_accounts() (accounting.storage.Storage method) +
      + + +
      get_balance() (accounting.client.Client method) +
      + +
      + +
      get_process() (accounting.storage.ledgercli.Ledger method) +
      + + +
      get_register() (accounting.client.Client method) +
      + + +
      get_transaction() (accounting.storage.Storage method) +
      + + +
      get_transactions() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +
      (accounting.storage.Storage method) +
      + + +
      (accounting.storage.sql.SQLStorage method) +
      + +
      +
      + +

      I

      + + + +
      + +
      id (accounting.storage.sql.models.Amount attribute) +
      + +
      + +
      (accounting.storage.sql.models.Posting attribute) +
      + + +
      (accounting.storage.sql.models.Transaction attribute) +
      + +
      + +
      index() (in module accounting.web) +
      + + +
      indicate_activity() (in module accounting.gtkclient) +
      + +
      + +
      indicate_activity_done() (in module accounting.gtkclient) +
      + + +
      init_ledger() (in module accounting.web) +
      + + +
      init_process() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +

      J

      + + +
      + +
      jsonify_exceptions() (in module accounting.decorators) +
      + +
      + +

      L

      + + + +
      + +
      Ledger (class in accounting.storage.ledgercli) +
      + + +
      load_ui() (accounting.gtkclient.AccountingApplication method) +
      + +
      + +
      locked_process() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +

      M

      + + + +
      + +
      main() (in module accounting.client) +
      + +
      + +
      (in module accounting.gtkclient) +
      + + +
      (in module accounting.storage.ledgercli) +
      + + +
      (in module accounting.web) +
      + +
      +
      + +
      meta (accounting.storage.sql.models.Posting attribute) +
      + +
      + +
      (accounting.storage.sql.models.Transaction attribute) +
      + +
      +
      + +

      O

      + + + +
      + +
      on_aboutdialog_close() (accounting.gtkclient.AccountingApplication method) +
      + + +
      on_refresh_transactions_activate() (accounting.gtkclient.AccountingApplication method) +
      + + +
      on_show_about_activate() (accounting.gtkclient.AccountingApplication method) +
      + +
      + +
      on_transaction_selected() (accounting.gtkclient.AccountingApplication method) +
      + + +
      on_transactions_loaded() (accounting.gtkclient.AccountingApplication method) +
      + +
      + +

      P

      + + + +
      + +
      payee (accounting.storage.sql.models.Transaction attribute) +
      + + +
      post() (accounting.client.Client method) +
      + + +
      Posting (class in accounting.models) +
      + +
      + +
      (class in accounting.storage.sql.models) +
      + +
      +
      + +
      print_balance_accounts() (in module accounting.client) +
      + + +
      print_transactions() (in module accounting.client) +
      + +
      + +

      R

      + + + +
      + +
      read_until_prompt() (accounting.storage.ledgercli.Ledger method) +
      + + +
      reg() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +
      reverse_transaction() (accounting.storage.Storage method) +
      + +
      + +

      S

      + + + +
      + +
      send_command() (accounting.storage.ledgercli.Ledger method) +
      + + +
      simple_transaction() (accounting.client.Client method) +
      + + +
      SQLStorage (class in accounting.storage.sql) +
      + +
      + +
      Storage (class in accounting.storage) +
      + + +
      symbol (accounting.storage.sql.models.Amount attribute) +
      + +
      + +

      T

      + + + +
      + +
      transaction (accounting.storage.sql.models.Posting attribute) +
      + + +
      Transaction (class in accounting.models) +
      + +
      + +
      (class in accounting.storage.sql.models) +
      + +
      + +
      transaction_get() (in module accounting.web) +
      + +
      + +
      transaction_post() (in module accounting.web) +
      + + +
      transaction_update() (in module accounting.web) +
      + + +
      transaction_uuid (accounting.storage.sql.models.Posting attribute) +
      + +
      + +

      U

      + + + +
      + +
      update_transaction() (accounting.storage.ledgercli.Ledger method) +
      + +
      + +
      (accounting.storage.Storage method) +
      + + +
      (accounting.storage.sql.SQLStorage method) +
      + +
      +
      + +
      uuid (accounting.storage.sql.models.Transaction attribute) +
      + +
      + + + + + + +
      +
      + + + + + +
      +
      +
      + + + + + \ No newline at end of file diff --git a/doc/build/html/index.html b/doc/build/html/index.html new file mode 100644 index 0000000..5de3006 --- /dev/null +++ b/doc/build/html/index.html @@ -0,0 +1,141 @@ + + + + + + + + Welcome to Accounting API’s documentation! — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + +
      + +
      +
      +

      Table Of Contents

      + + +

      Next topic

      +

      accounting package

      +

      This Page

      + + + +
      +
      +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/objects.inv b/doc/build/html/objects.inv new file mode 100644 index 0000000..49a7cb2 Binary files /dev/null and b/doc/build/html/objects.inv differ diff --git a/doc/build/html/py-modindex.html b/doc/build/html/py-modindex.html new file mode 100644 index 0000000..f8a68ac --- /dev/null +++ b/doc/build/html/py-modindex.html @@ -0,0 +1,169 @@ + + + + + + + + Python Module Index — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + + + +
      +
      +
      +
      + + +

      Python Module Index

      + +
      + a +
      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
       
      + a
      + accounting +
          + accounting.client +
          + accounting.config +
          + accounting.decorators +
          + accounting.exceptions +
          + accounting.gtkclient +
          + accounting.models +
          + accounting.storage +
          + accounting.storage.ledgercli +
          + accounting.storage.sql +
          + accounting.storage.sql.models +
          + accounting.transport +
          + accounting.web +
      + + +
      +
      +
      +
      +
      + + +
      +
      +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/search.html b/doc/build/html/search.html new file mode 100644 index 0000000..46944b6 --- /dev/null +++ b/doc/build/html/search.html @@ -0,0 +1,105 @@ + + + + + + + + Search — Accounting API 0.1-beta documentation + + + + + + + + + + + + + + + + + + + +
      +
      +
      +
      + +

      Search

      +
      + +

      + Please activate JavaScript to enable the search + functionality. +

      +
      +

      + From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list. +

      +
      + + + +
      + +
      + +
      + +
      +
      +
      +
      +
      +
      +
      +
      +
      + + + + \ No newline at end of file diff --git a/doc/build/html/searchindex.js b/doc/build/html/searchindex.js new file mode 100644 index 0000000..29d5bf8 --- /dev/null +++ b/doc/build/html/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({terms:{transaction_id:[4,3],skipkei:4,decod:[],get_transact:[2,3],init_ledg:4,locked_process:3,clariti:[],load_ui:4,on_show_about_activ:4,request:4,"true":[4,3],app:[2,3],reg:[4,3],donat:4,result:3,kwarg:2,high:4,content:[],sourc:[4,2,3],post:[4,2],until:3,sinc:3,set:3,before_request:4,index:[1,4],text:3,meta:2,write:[4,3],expens:[],init_process:3,"new":3,alreadi:3,read_until_prompt:3,setup:4,accountingexcept:4,recommend:3,separ:4,output:[4,3],execut:3,ledger:[4,3],unlock:3,"default":4,blah:[],name:4,get_account:3,command:3,to_acc:4,requir:4,contain:4,creat:3,amount_id:2,ensure_ascii:4,annot:4,run:3,accountingdecod:4,endpoint:4,flask:4,symbol:[4,2],sqlstorag:2,from:3,amount:[4,2],instanc:3,ani:4,argument:3,json:4,list:3,metadata:4,lock:3,http:[],storag:[],widget:4,get_bal:4,get_process:3,handl:3,as_dict:2,send_command:3,jsondecod:4,without:3,simple_transact:4,find:3,linebreak:[],subprocess:3,ledger_bin:3,json_encod:4,initi:4,"catch":4,uuid:2,"__type__":4,search:1,state:4,incom:4,"_generate_id":4,base:[4,2,3],logic:4,presum:3,evalu:3,world:4,page:1,ledger_fil:3,assemble_argu:3,ledgercli:[],func_or_str:4,contextmanag:3,generate_id:4,wget:[],jsonify_except:4,transaction_upd:4,transact:[4,2,3],read:3,"class":[4,2,3],accountingappl:4,json_decod:4,on_refresh_transactions_activ:4,update_transact:[2,3],prompt:3,version:[],dict_to_object:4,reverse_transact:3,self:3,contextlib:3,payload:4,take:4,yield:3,log:[],transaction_post:4,via:4,print_balance_account:4,wrap:4,exampl:[],on_transactions_load:4,object:[4,3],paye:[4,2],main:[4,3],file:[4,3],rest:4,pars:[],transaction_get:4,indent:4,discard:3,arg:[2,3],banner:3,caller:4,jsonencod:4,ledger_process:3,none:[4,2,3],host:4,sql:[],add_transact:[2,3],sort_kei:4,popen:3,argv:[4,3],register_report:[],hello:4,process:3,thi:[4,3],serial:4,applic:[],allow_nan:4,level:4,fals:4,suitabl:3,method:4,context:3,on_aboutdialog_clos:4,flask_sqlalchemi:2,"return":[4,3],donor:4,foo:4,mode:3,on_transaction_select:4,x20:3,prog:4,parse_json:[],karma:[],debug:[],statement:3,onc:3,func:4,webservic:4,when:3,from_acc:4,current:4,kindli:4,check_circular:4,abc:3,print_transact:4,manag:3,indicate_activity_don:4,asset:4,becom:4,combin:3,bal:3,should:3,transaction_uuid:2,get_regist:4,indicate_act:4,curl:[],which:[4,3],data:[],check:[4,3],path:4,date:[4,2],balance_report:[],get:4,stdin:3,open:3,type:[],balanc:[],accountingencod:4,builtin:[4,3]},envversion:43,titleterms:{subpackag:[4,3],model:[4,2],document:1,api:1,asyncio:[],transport:4,decor:4,except:4,gtkclient:4,config:4,tabl:1,indic:1,sql:2,account:[0,1,2,3,4],client:4,storag:[2,3],submodul:[4,2,3],ledgercli:3,content:[4,2,3],titl:[],test:[],packag:[4,2,3],modul:[4,2,3],web:4,welcom:1},objects:{"":{accounting:[4,0,0,"-"]},"accounting.storage.sql":{models:[2,0,0,"-"],SQLStorage:[2,5,1,""]},"accounting.storage.Storage":{get_accounts:[3,2,1,""],get_account:[3,2,1,""],get_transaction:[3,2,1,""],update_transaction:[3,2,1,""],reverse_transaction:[3,2,1,""],get_transactions:[3,2,1,""]},"accounting.storage.ledgercli":{main:[3,3,1,""],Ledger:[3,5,1,""]},"accounting.models":{Posting:[4,5,1,""],Transaction:[4,5,1,""],Account:[4,5,1,""],Amount:[4,5,1,""]},"accounting.storage.sql.models":{Posting:[2,5,1,""],Transaction:[2,5,1,""],Amount:[2,5,1,""]},"accounting.models.Transaction":{generate_id:[4,2,1,""]},"accounting.storage.sql.models.Posting":{amount_id:[2,1,1,""],as_dict:[2,2,1,""],transaction:[2,1,1,""],transaction_uuid:[2,1,1,""],id:[2,1,1,""],meta:[2,1,1,""],account:[2,1,1,""],amount:[2,1,1,""]},"accounting.gtkclient":{indicate_activity_done:[4,3,1,""],AccountingApplication:[4,5,1,""],main:[4,3,1,""],indicate_activity:[4,3,1,""]},"accounting.transport.AccountingDecoder":{dict_to_object:[4,2,1,""]},"accounting.storage.sql.models.Amount":{as_dict:[2,2,1,""],amount:[2,1,1,""],id:[2,1,1,""],symbol:[2,1,1,""]},"accounting.transport":{AccountingDecoder:[4,5,1,""],AccountingEncoder:[4,5,1,""]},"accounting.gtkclient.AccountingApplication":{on_show_about_activate:[4,2,1,""],on_aboutdialog_close:[4,2,1,""],on_transaction_selected:[4,2,1,""],on_refresh_transactions_activate:[4,2,1,""],on_transactions_loaded:[4,2,1,""],load_ui:[4,2,1,""]},"accounting.storage":{Storage:[3,5,1,""],sql:[2,0,0,"-"],ledgercli:[3,0,0,"-"]},"accounting.transport.AccountingEncoder":{"default":[4,2,1,""]},"accounting.storage.sql.models.Transaction":{meta:[2,1,1,""],as_dict:[2,2,1,""],payee:[2,1,1,""],id:[2,1,1,""],uuid:[2,1,1,""],date:[2,1,1,""]},"accounting.storage.sql.SQLStorage":{get_transactions:[2,2,1,""],add_transaction:[2,2,1,""],update_transaction:[2,2,1,""]},accounting:{decorators:[4,0,0,"-"],config:[4,0,0,"-"],web:[4,0,0,"-"],gtkclient:[4,0,0,"-"],storage:[3,0,0,"-"],models:[4,0,0,"-"],exceptions:[4,0,0,"-"],client:[4,0,0,"-"],transport:[4,0,0,"-"]},"accounting.client.Client":{get:[4,2,1,""],get_balance:[4,2,1,""],post:[4,2,1,""],simple_transaction:[4,2,1,""],get_register:[4,2,1,""]},"accounting.web":{index:[4,3,1,""],transaction_update:[4,3,1,""],transaction_post:[4,3,1,""],init_ledger:[4,3,1,""],main:[4,3,1,""],transaction_get:[4,3,1,""]},"accounting.decorators":{jsonify_exceptions:[4,3,1,""]},"accounting.storage.ledgercli.Ledger":{reg:[3,2,1,""],init_process:[3,2,1,""],assemble_arguments:[3,2,1,""],add_transaction:[3,2,1,""],read_until_prompt:[3,2,1,""],update_transaction:[3,2,1,""],locked_process:[3,2,1,""],bal:[3,2,1,""],get_transactions:[3,2,1,""],get_process:[3,2,1,""],send_command:[3,2,1,""]},"accounting.exceptions":{AccountingException:[4,4,1,""]},"accounting.client":{main:[4,3,1,""],print_balance_accounts:[4,3,1,""],Client:[4,5,1,""],print_transactions:[4,3,1,""]}},filenames:["api/modules","index","api/accounting.storage.sql","api/accounting.storage","api/accounting"],titles:["accounting","Welcome to Accounting API’s documentation!","accounting.storage.sql package","accounting.storage package","accounting package"],objtypes:{"0":"py:module","1":"py:attribute","2":"py:method","3":"py:function","4":"py:exception","5":"py:class"},objnames:{"0":["py","module","Python module"],"1":["py","attribute","Python attribute"],"2":["py","method","Python method"],"3":["py","function","Python function"],"4":["py","exception","Python exception"],"5":["py","class","Python class"]}}) \ No newline at end of file diff --git a/doc/source/api/accounting.rst b/doc/source/api/accounting.rst index 845b639..91469dd 100644 --- a/doc/source/api/accounting.rst +++ b/doc/source/api/accounting.rst @@ -43,6 +43,14 @@ accounting.exceptions module :undoc-members: :show-inheritance: +accounting.gtkclient module +--------------------------- + +.. automodule:: accounting.gtkclient + :members: + :undoc-members: + :show-inheritance: + accounting.models module ------------------------