Index: gignore =================================================================== --- .hgignore (revision 62) +++ (revision ) @@ -1,10 +1,0 @@ -syntax: glob - -.DS_Store -*.pyc -*.orig -stamper.egg-info/ -dist/ -graphs/ -build/ - Index: gtags =================================================================== --- .hgtags (revision 49) +++ (revision ) @@ -1,1 +1,0 @@ -e1a22d078bbbb3b4695fbc80f0cbf55de3ea76a1 0.1 Index: INSTALL =================================================================== --- INSTALL (revision 57) +++ INSTALL (revision 0) @@ -9,5 +9,5 @@ So far, the only dependency you will need in order to run stamper is Python [1]_ -Stamper has been tested with python *2.7.x*, but it should work with versions +Mailjam has been tested with python *2.7.x*, but it should work with versions *2.6.x* too. @@ -16,5 +16,5 @@ -Second, install Stamper +Second, install Mailjam ----------------------- Index: LICENSE =================================================================== --- LICENSE (revision 45) +++ LICENSE (revision 0) @@ -1,3 +1,3 @@ -Copyright (c) 2014, Soluciones Informaticas Codigo23 S.L.U. +Copyright (c) 2012, Soluciones Informaticas Codigo23 S.L.U. All rights reserved. Index: ADME.rst =================================================================== --- README.rst (revision 70) +++ (revision ) @@ -1,31 +1,0 @@ -Stamper - Track your worktime -============================= - -.. contents:: - - -Introduction ------------- - -Stamper is a time tracking tool. It allows you to record how much time you -have dedicated to a given task. - -Install -------- - -For installation instructions, please check the INSTALL file, or the -documentation inside the docs/ subdirectory. - -You can read the installation instructions here: -http://readthedocs.org/docs/stamper/en/latest/install.html - -Documentation -------------- - -The official documentation is available in the docs/ subdirectory, and -you can read the docs online too (thnx to readthedocs.org [1]_): - -http://stamper.readthedocs.org - - -.. [1] http://readthedocs.org Index: DO =================================================================== --- TODO (revision 64) +++ (revision ) @@ -1,34 +1,0 @@ -Stamper - TODO list -=================== - -Ongoing work ------------- - -- make the report 'templatable' -- move filters to their own module -- "days ago" date filter - - -Tasks done ----------- -- 'stamps customer', report with customer -- 'stamps customer details', report with customer and details -- improve arguments parsing -- 'stamps customer details 20140701 20140703' report with customer per dates -- 'stamps details', report without customer -- 'stamps details 20140701 20140703', report without customer per dates -- 'stamps details 15d', report with default date range -- 'stamps customer details 15d', report with customer and default date range -- 'timeline n' tool to see last n stamps -- bar graphs: hours-per-period/customer -- bar graphs: hours-per-period/aggregate-customers (all the customers) -- stamp without quotes - - - -BUGS ----- - -- stamps customer -v does not show the details ordered by date [FIXED] -- wrong stamps calculation when a stamp is not closed between two days - (starting the stamp one day and ending the next day, after the 12pm) Index: bin/calc =================================================================== --- bin/calc (revision 0) +++ bin/calc (revision 0) @@ -0,0 +1,52 @@ +#!/usr/bin/env python + +import sys +from stamper import Stamper + + +def usage(name): + msg = """ + Usage: + + To gather information of recorded times: %(name)s + + Recorded times for a given customer: %(name)s customer + + Detailed times for a given customer: %(name)s customer details + """ % {'name': name} + print(msg) + + +if __name__ == '__main__': + + s = Stamper() + s.load_stamps() + + if len(sys.argv) == 1: + totals = s.totals() + print('Total times for all customers:') + for t in totals: + print(' -> %(customer)s: %(total)s' % {'customer': t, + 'total': totals[t]}) + elif len(sys.argv) == 2: + if sys.argv[1] in s.customers(): + print('Total time for %(customer)s: %(total)s' % { + 'customer': sys.argv[1], + 'total': s.total_by_customer(sys.argv[1]) + }) + + elif len(sys.argv) == 3: + if sys.argv[1] in s.customers(): + print('Detailed time for %(customer)s' % { + 'customer': sys.argv[1], + }) + details, totals = s.details_by_customer(sys.argv[1]) + for day in details: + print('------ %(day)s ------' % {'day': day}) + for line in details[day]: + print(line) + print(' Total: %(total)s' % {'total': totals[day]}) + + else: + usage(sys.argv[0]) + sys.exit(1) Index: bin/stamp =================================================================== --- bin/stamp (revision 71) +++ bin/stamp (revision 0) @@ -3,5 +3,5 @@ import sys from datetime import datetime -from stamper.stamper import Stamper +from stamper import DATE_FORMAT, Stamper @@ -24,8 +24,7 @@ if len(sys.argv) == 1: # stamp! - s.stamp(datetime.today().strftime(s.datetime_format), - None, None, None) + s.stamp(datetime.today().strftime(DATE_FORMAT), None, None, None) - elif len(sys.argv) >= 3: + elif len(sys.argv) == 3: # record! last_stamp = s.last_stamp() @@ -33,8 +32,6 @@ if not current_start: current_start = last_stamp['start'] - customer = sys.argv[1] - description = ' '.join(sys.argv[2:]) - s.stamp(current_start, datetime.today().strftime(s.datetime_format), - customer, description) + s.stamp(current_start, datetime.today().strftime(DATE_FORMAT), + sys.argv[1], sys.argv[2]) else: Index: n/stamp2json =================================================================== --- bin/stamp2json (revision 18) +++ (revision ) @@ -1,83 +1,0 @@ -#!/usr/bin/env python - -import json -import sys -from argparse import ArgumentParser -from os.path import expanduser, isfile, isdir - - -def args_cmd(): - """Parse the command line arguments via argparse""" - parser = ArgumentParser(description='Convert tool from txt to json format') - parser.add_argument( - '--input', '-i', default=expanduser('~/.workstamps.txt'), - help='Input filename (default ~/.workstamps.txt') - parser.add_argument( - '--output', '-o', default=expanduser('~/.workstamps.json'), - help='Input filename (default: ~/.workstamps.json)') - return parser.parse_args() - - -def itemify(line): - """Split a line, returning date and the rest of data""" - line = line.strip() - end_time = line[:16] - info = line[17:] - return(line[:16], line[17:]) - - -if __name__ == '__main__': - args = args_cmd() - - stamps = [] - - with open(args.input, 'r') as infile: - - for line in infile: - time, info = itemify(line) - - if info == 'start': - customer = None - action = None - start_time = time - end_time = None - - elif time == 'restarttotals': - continue - - else: - info_items = info.split(' ', 1) - customer = info_items[0] - action = '' - if len(info_items) > 1: - action = info_items[1].lstrip('- ') - # if the previous line was not a start line, took the previous - # line end time as start time - if end_time is not None: - start_time = end_time - end_time = time - - stamps.append({ - 'start': start_time, - 'end': end_time, - 'customer': customer, - 'action': action, - }) - - if isfile(args.output): - print('[warning] %(out)s already exist' - % {'out': args.output}) - confirm = raw_input('overwrite? (y/n) ') - while confirm not in ['y','n','Y','N']: - confirm = raw_input('overwrite? (y/n) ') - if confirm in ['n', 'N']: - print('[warning] exiting without converting') - sys.exit() - - elif isdir(args.output): - print('[error] %(out)s is a directory, remove it first' - % {'out': args.output}) - sys.exit(1) - - with open(args.output, 'w') as stamps_file: - json.dump(stamps, stamps_file, indent=4) Index: n/stamps =================================================================== --- bin/stamps (revision 71) +++ (revision ) @@ -1,34 +1,0 @@ -#!/usr/bin/env python - -from stamper.cli import build_args_parser -from stamper.stamper import Stamper - - -if __name__ == '__main__': - - parser = build_args_parser() - args = parser.parse_args() - - s = Stamper() - s.load_stamps() - - # Set proper arguments if they have passed a date-based filter without - # a customer - if args.customer not in s.customers and not args.filter: - args.filter = args.customer - args.customer = None - - # Call the proper methods, based on the given parameters - if args.timeline: - s.timeline(args.customer, args.filter, args.description) - elif args.delete: - s.remove_stamps(args.delete) - elif args.graph: - s.graph_stamps(args.customer, args.filter, args.description) - elif args.import_file: - s.import_stamps(args.import_file) - elif args.push: - s.push_stamps(args.customer, args.filter, args.description) - else: - s.show_stamps(args.customer, args.filter, args.verbose, args.sum, - args.description) Index: n/time_sum =================================================================== --- bin/time_sum (revision 14) +++ (revision ) @@ -1,47 +1,0 @@ -#!/usr/bin/env python - -import sys -import time - -TIME_FORMAT= "%H:%M" -HOURS_DAY = 8 -SECS_DAY = HOURS_DAY * 60 * 60 - -def usage(name): - msg = """ -time_sum.py: Sum dates in proper hour time - -Params: Worked hours -Syntax: $ ./time_sum 6:45 13:48 12:44 8:28 14:43 -56:28 min. = 7 days, remaining: 0:28 (8 hours/day) -""" - print(msg) - exit(1) - -def isTimeFormat(input): - try: - time.strptime(input, TIME_FORMAT) - return True - except ValueError: - return False - - -if __name__ == '__main__': - - totalSecs = 0 - for param in sys.argv[1:]: - if not isTimeFormat(param): - print("Invalid hour format: %s" % param) - help() - exit(1) - timeParts = [int(s) for s in param.split(':')] - totalSecs += (timeParts[0] * 60 + timeParts[1]) * 60 - - totalDays, remaining = divmod(totalSecs, SECS_DAY) - remainingMin, remainingSec = divmod(remaining, (60)) - remainingHr, remainingMin = divmod(remainingMin, (60)) - - totalSecs, sec = divmod(totalSecs, 60) - hr, min = divmod(totalSecs, 60) - print "%d:%02d hours. = %d days, remaining: %d:%02d (%d hours/day)" % ( - hr, min, totalDays, remainingHr, remainingMin, HOURS_DAY) Index: cs/Makefile =================================================================== --- docs/Makefile (revision 42) +++ (revision ) @@ -1,177 +1,0 @@ -# Makefile for Sphinx documentation -# - -# You can set these variables from the command line. -SPHINXOPTS = -SPHINXBUILD = sphinx-build -PAPER = -BUILDDIR = _build - -# User-friendly check for sphinx-build -ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1) -$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/) -endif - -# Internal variables. -PAPEROPT_a4 = -D latex_paper_size=a4 -PAPEROPT_letter = -D latex_paper_size=letter -ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . -# the i18n builder cannot share the environment and doctrees with the others -I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . - -.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext - -help: - @echo "Please use \`make ' where is one of" - @echo " html to make standalone HTML files" - @echo " dirhtml to make HTML files named index.html in directories" - @echo " singlehtml to make a single large HTML file" - @echo " pickle to make pickle files" - @echo " json to make JSON files" - @echo " htmlhelp to make HTML files and a HTML help project" - @echo " qthelp to make HTML files and a qthelp project" - @echo " devhelp to make HTML files and a Devhelp project" - @echo " epub to make an epub" - @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" - @echo " latexpdf to make LaTeX files and run them through pdflatex" - @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" - @echo " text to make text files" - @echo " man to make manual pages" - @echo " texinfo to make Texinfo files" - @echo " info to make Texinfo files and run them through makeinfo" - @echo " gettext to make PO message catalogs" - @echo " changes to make an overview of all changed/added/deprecated items" - @echo " xml to make Docutils-native XML files" - @echo " pseudoxml to make pseudoxml-XML files for display purposes" - @echo " linkcheck to check all external links for integrity" - @echo " doctest to run all doctests embedded in the documentation (if enabled)" - -clean: - rm -rf $(BUILDDIR)/* - -html: - $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html - @echo - @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." - -dirhtml: - $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml - @echo - @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." - -singlehtml: - $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml - @echo - @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." - -pickle: - $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle - @echo - @echo "Build finished; now you can process the pickle files." - -json: - $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json - @echo - @echo "Build finished; now you can process the JSON files." - -htmlhelp: - $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp - @echo - @echo "Build finished; now you can run HTML Help Workshop with the" \ - ".hhp project file in $(BUILDDIR)/htmlhelp." - -qthelp: - $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp - @echo - @echo "Build finished; now you can run "qcollectiongenerator" with the" \ - ".qhcp project file in $(BUILDDIR)/qthelp, like this:" - @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Stamper.qhcp" - @echo "To view the help file:" - @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Stamper.qhc" - -devhelp: - $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp - @echo - @echo "Build finished." - @echo "To view the help file:" - @echo "# mkdir -p $$HOME/.local/share/devhelp/Stamper" - @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Stamper" - @echo "# devhelp" - -epub: - $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub - @echo - @echo "Build finished. The epub file is in $(BUILDDIR)/epub." - -latex: - $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex - @echo - @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." - @echo "Run \`make' in that directory to run these through (pdf)latex" \ - "(use \`make latexpdf' here to do that automatically)." - -latexpdf: - $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex - @echo "Running LaTeX files through pdflatex..." - $(MAKE) -C $(BUILDDIR)/latex all-pdf - @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." - -latexpdfja: - $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex - @echo "Running LaTeX files through platex and dvipdfmx..." - $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja - @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." - -text: - $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text - @echo - @echo "Build finished. The text files are in $(BUILDDIR)/text." - -man: - $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man - @echo - @echo "Build finished. The manual pages are in $(BUILDDIR)/man." - -texinfo: - $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo - @echo - @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." - @echo "Run \`make' in that directory to run these through makeinfo" \ - "(use \`make info' here to do that automatically)." - -info: - $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo - @echo "Running Texinfo files through makeinfo..." - make -C $(BUILDDIR)/texinfo info - @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." - -gettext: - $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale - @echo - @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." - -changes: - $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes - @echo - @echo "The overview file is in $(BUILDDIR)/changes." - -linkcheck: - $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck - @echo - @echo "Link check complete; look for any errors in the above output " \ - "or in $(BUILDDIR)/linkcheck/output.txt." - -doctest: - $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest - @echo "Testing of doctests in the sources finished, look at the " \ - "results in $(BUILDDIR)/doctest/output.txt." - -xml: - $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml - @echo - @echo "Build finished. The XML files are in $(BUILDDIR)/xml." - -pseudoxml: - $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml - @echo - @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." Index: cs/_build/html/.buildinfo =================================================================== --- docs/_build/html/.buildinfo (revision 42) +++ (revision ) @@ -1,4 +1,0 @@ -# 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: 12f4ca753bd848f04b858e41ae2ca811 -tags: 645f666f9bcd5a90fca523b33c5a78b7 Index: cs/_build/html/_sources/about.txt =================================================================== --- docs/_build/html/_sources/about.txt (revision 42) +++ (revision ) @@ -1,85 +1,0 @@ -About Stamper -============= - -.. contents:: - - -From where does it come from? ------------------------------ - -Stamper_ was born strongly inspired by the original stamp_ tool written by -`Sascha Welter`_ (aka betabug_). - -The idea is quite simple: - -1. You **stamp** a time in a text file, recording that time as the time when - you started working on something:: - - 2014-08-13 09:45 start - -2. You **stamp** again once you have finished, providing something like an id - (to identify a customer, project, whatever) and a description of what you - did:: - - 2014-08-13 10:45 stamper writing documentation - -Those times are saved into a text file and afterwards, with a little bit of -python_ magic, you get some reports about the amount of time dedicated per -day or id (for example). - - -Enter the JSON --------------- - -Betabug's stamp tool records those times as lines in a text file. This is quite -convenient because you can look into the file with traditional tools like *cat*, -*head* or *tail*, or even open it with your favourite editor, and get -information about the times you've spent working on something. - -But this comes *at a cost*, it needs some *ugly* parsing of the .txt file in the -python code that calculates the statistics and reports, making it difficult/slow -to perform certain tasks. - -**And here it comes JSON:** - -:: - - JSON (JavaScript Object Notation) is a lightweight data-interchange format. - It is easy for humans to read and write. It is easy for machines to parse - and generate. It is based on a subset of the JavaScript Programming Language, - Standard ECMA-262 3rd Edition - December 1999. JSON is a text format that is - completely language independent but uses conventions that are familiar to - programmers of the C-family of languages, including C, C++, C#, Java, - JavaScript, Perl, Python, and many others. These properties make JSON an - ideal data-interchange language. - -(extracted from http://json.org) - -Using a .json file instead of a txt file, we can export/import python data -structures (like lists or dicts) easily into a text-like file. This means that -we can still edit the file using a text editor, or check its contents using -*cat*, *head* or *tail*, but we can forget about the parsing of the entries. - - -The tools ---------- - -Stamper_ comes with a variety of tools, but the most used ones are: - -- **stamp:** Use this to *stamp* times into the json file. - -- **stamps:** USe this to query the json file and obtain information about your - stamped times. - -.. seealso:: - - :doc:using - - - -.. _Stamper: https://bitbucket.org/codigo23/stamper -.. _stamp: http://repos.betabug.ch/stamp -.. _`Sascha Welter`: http://betabug.ch -.. _`betabug`: http://betabug.ch -.. _python: http://python.org -.. _JSON: Index: cs/_build/html/_sources/index.txt =================================================================== --- docs/_build/html/_sources/index.txt (revision 42) +++ (revision ) @@ -1,31 +1,0 @@ -.. Stamper documentation master file, created by - sphinx-quickstart on Wed Aug 13 21:25:05 2014. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to Stamper's documentation! -=================================== - -This is the official documentation for Stamper_, a *time tracking* tool written -in Python_. - -Contents: - -.. toctree:: - :maxdepth: 2 - - about - install - using - - - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - -.. _Stamper: https://bitbucket.org/codigo23/stamper -.. _Python: http://python.org Index: cs/_build/html/_sources/install.txt =================================================================== --- docs/_build/html/_sources/install.txt (revision 42) +++ (revision ) @@ -1,24 +1,0 @@ -Installation instructions -========================= - -Installing Stamper_ is quite easy. If you have some experience installing -Python_ packages [1]_, you already know how to do it. Stamper is a standard -Python_ package available on pypi_ [2]_ so just use your favourite tool -(pip_, easy_install_, etc) to intall it:: - - pip install Stamper - -:: - - easy_install Stamper - - -.. _Stamper: https://bitbucket.org/codigo23/stamper -.. _Python: http://python.org -.. _pip: http://www.pip-installer.org/en/latest/index.html -.. _pypi: http://pypi.python.org/pypi -.. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall - - -.. [1] http://docs.python.org/tutorial/modules.html#packages -.. [2] http://pypi.python.org/pypi/stamper Index: cs/_build/html/_sources/using.txt =================================================================== --- docs/_build/html/_sources/using.txt (revision 48) +++ (revision ) @@ -1,221 +1,0 @@ -How to use it -============= - -.. contents:: - - -Recording time --------------- - -To start recording time:: - - stamp - -To stop recording time:: - - stamp ID DESCRIPTION - -where: - -- **ID** is a string **without spaces** identifying a customer, project, - group of tasks or any other thing you want to use to group your stamps - -- **DESCRIPTION** is a description of what you did - -for example:: - - stamp stamper writing documentation - -or:: - - stamp stamper implementing per-month line charts - - -Recording consecutive stamps -++++++++++++++++++++++++++++ - -Imagine you start working on a project, you *stamp* your start:: - - stamp - -and then you finish a given task, so you *stamp* it:: - - stamp stamper writing installation instructions - -but then, you keep yourself working on the same project, but on some other -task. You don't have to *stamp* the start time again, you simply *stamp* again -when you finish the work on that other task:: - - stamp stamper writing usage instructions - -.. note:: - - This apply also for changing to another project, you don't have to *stamp* - the start time again, just keep stamping the end times. In such a situation, - Stamper will take the end time of a recorded stamp as the start time of the - next one. - - -Retrieving information from the existing stamps ------------------------------------------------ - -Total times -+++++++++++ - -- Get a list of total times stamped per **ID**:: - - stamps - -- Get the total times stamped for a given **ID**, for example, **stamper**:: - - stamps stamper - -- Get the total times stamped for the **ID** **stamper** during the last - week:: - - stamps stamper 1w - - .. seealso:: - - *1w* is a date-based filter. You can learn more about those filters - in the :ref:`date_based_filtering` documentation below. - -Per day details -+++++++++++++++ - -- Get a list of detailed per-day times:: - - stamps -v - -- Get details for a given **ID**, for example, **stamper**:: - - stamps -v stamper - -- Get details for a given month, for example, *august 2014*:: - - stamps -v 2014-08-01--2014-09-01 - - .. seealso:: - - *2014-08-01--2014-09-01* is a date-based filter. You can learn more about - those filters in the :ref:`date_based_filtering` documentation below. - -Timeline -++++++++ - -You can get a *timeline* of all the stamped stamps:: - - stamps -t - -This *timeline* will show each stamp in a line, in a similar way to what bebu's -stamp [1]_ stores in its text-based file:: - - 2014-08-12 12:33 start - 2014-08-12 12:51 stamper writing installation instructions - 2014-08-12 13:11 stamper writing usage documentation - 2014-08-13 09:33 start - 2014-08-13 12:12 stamper adding missing tests for the cli tools - -You can filter the timeline by **ID**:: - - stamps -t stamper - -And/or by date:: - - stamps -t 2m - - .. seealso:: - - *2m* is a date-based filter. You can learn more about those filters - in the :ref:`date_based_filtering` documentation below. - - -Charts -++++++ - -You can generate some nice charts from your stamps. So far only bar charts -showing the total time per day can be generated, but you can filter them by -**ID** and/or date. Some examples: - -- Render a chart of all the times already stamped, by **ID**:: - - stamps -g - -- Render a chart of the stamps for the last 4 days:: - - stamps -g 4d - -- Render a chart of the stamps for the **ID** *stamper* for the last week:: - - stamps -g stamper 1w - -.. note:: - - The charts will be saved into **~/.workstamps-charts**, in SVG_ format. - The name of the chart will be generated based on the current date and - time, and a *symbolic link* called **chart-latest.svg** will be created, - pointing to the latest chart generated. - - -stamps - full List of arguments -------------------------------- - -You can get the full list of arguments from the command line:: - - stamps -h - -or:: - - stamps --help - - - -.. _date_based_filtering: - -Date-based filtering --------------------- - -Most of the results returned by the *stamps* tool can be filtered using the -following date-based filters: - -- **YYYY-MM-DD**: Limit the results to only those stamps stamped on this date:: - - stamps -v 2014-08-13 - - :: - - stamps -t stamper 2014-08-13 - -- **YYYY-MM-DD\***: Limit the results to only those stamps stamped **after this - date**. For example, this will show per-day details for stamps stamped after - the first of august, 2014:: - - stamps -v 2014-08-01* - -- **\*YYYY-MM-DD**: Limit the results to only those stamps stamped **before this - date**. For example this will show the total time stamped for project stamper - before the first of january, 2014:: - - stamps stamper *2014-01-01 - -- **YYYY-MM-DD--YYYY-MM-DD**: Limit the results to only those stamps stamped in - a date **between those dates**. For example, this will show the *timeline* for - july, 2014:: - - stamps -t 2014-07-01--2014-08-01 - -- **nD|W|M|Y**: Limit the results to only those stamps stamped since n *days* - (**D**), *weeks* (**W**), *months* (**M**) or *years* (**Y**) ago. - For example, this will show the details for the last month:: - - stamps -v 1m - - .. note:: - - It does not matter if you provide *d|w|m|y* or *D|W|M|Y*. The filters are - handled in a case-insensitive way. - - -.. _SVG: http://en.wikipedia.org/wiki/Scalable_Vector_Graphics - -.. [1] http://repos.betabug.ch/stamp Index: cs/_build/html/_static/basic.css =================================================================== --- docs/_build/html/_static/basic.css (revision 42) +++ (revision ) @@ -1,537 +1,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2014 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; - max-width: 100%; -} - -/* -- 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; - } -} Index: cs/_build/html/_static/default.css =================================================================== --- docs/_build/html/_static/default.css (revision 42) +++ (revision ) @@ -1,256 +1,0 @@ -/* - * default.css_t - * ~~~~~~~~~~~~~ - * - * Sphinx stylesheet -- default theme. - * - * :copyright: Copyright 2007-2014 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; -} Index: cs/_build/html/_static/doctools.js =================================================================== --- docs/_build/html/_static/doctools.js (revision 42) +++ (revision ) @@ -1,238 +1,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilities for all documentation. - * - * :copyright: Copyright 2007-2014 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'); - if (!body.length) { - body = $('body'); - } - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('

' + _('Hide Search Matches') + '

') - .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(); -}); Index: cs/_build/html/_static/jquery.js =================================================================== --- docs/_build/html/_static/jquery.js (revision 42) +++ (revision ) @@ -1,2 +1,0 @@ -/*! 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); Index: cs/_build/html/_static/pygments.css =================================================================== --- docs/_build/html/_static/pygments.css (revision 42) +++ (revision ) @@ -1,62 +1,0 @@ -.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 */ Index: cs/_build/html/_static/searchtools.js =================================================================== --- docs/_build/html/_static/searchtools.js (revision 42) +++ (revision ) @@ -1,622 +1,0 @@ -/* - * searchtools.js_t - * ~~~~~~~~~~~~~~~~ - * - * Sphinx JavaScript utilties for the full-text search. - * - * :copyright: Copyright 2007-2014 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); - } -}); Index: cs/_build/html/about.html =================================================================== --- docs/_build/html/about.html (revision 42) +++ (revision ) @@ -1,195 +1,0 @@ - - - - - - - - About Stamper — Stamper 0.1 documentation - - - - - - - - - - - - - - -
      -

      Navigation

      - -
      - -
      -
      -
      -
      - -
      -

      About Stamper

      - -
      -

      From where does it come from?

      -

      Stamper was born strongly inspired by the original stamp tool written by -Sascha Welter (aka betabug).

      -

      The idea is quite simple:

      -
        -

      1. You stamp a time in a text file, recording that time as the time when -you started working on something:

        -
        2014-08-13 09:45 start
-
        -
        -
        2. -

      2. You stamp again once you have finished, providing something like an id -(to identify a customer, project, whatever) and a description of what you -did:

        -
        2014-08-13 10:45 stamper writing documentation
-
        -
        -
        3. -
      -

      Those times are saved into a text file and afterwards, with a little bit of -python magic, you get some reports about the amount of time dedicated per -day or id (for example).

      -
      -
      -

      Enter the JSON

      -

      Betabug’s stamp tool records those times as lines in a text file. This is quite -convenient because you can look into the file with traditional tools like cat, -head or tail, or even open it with your favourite editor, and get -information about the times you’ve spent working on something.

      -

      But this comes at a cost, it needs some ugly parsing of the .txt file in the -python code that calculates the statistics and reports, making it difficult/slow -to perform certain tasks.

      -

      And here it comes JSON:

      -
      JSON (JavaScript Object Notation) is a lightweight data-interchange format.
-It is easy for humans to read and write. It is easy for machines to parse
-and generate. It is based on a subset of the JavaScript Programming Language,
-Standard ECMA-262 3rd Edition - December 1999. JSON is a text format that is
-completely language independent but uses conventions that are familiar to
-programmers of the C-family of languages, including C, C++, C#, Java,
-JavaScript, Perl, Python, and many others. These properties make JSON an
-ideal data-interchange language.
-
      -
      -

      (extracted from http://json.org)

      -

      Using a .json file instead of a txt file, we can export/import python data -structures (like lists or dicts) easily into a text-like file. This means that -we can still edit the file using a text editor, or check its contents using -cat, head or tail, but we can forget about the parsing of the entries.

      -
      -
      -

      The tools

      -

      Stamper comes with a variety of tools, but the most used ones are:

      -
        -
      • stamp: Use this to stamp times into the json file.
        • -
      • stamps: USe this to query the json file and obtain information about your -stamped times.
        • -
      -
      -

      See also

      -

      :doc:using

      -
      -
      -
      - - -
      -
      -
      -
      -
      -

      Table Of Contents

      - - -

      Previous topic

      -

      Welcome to Stamper’s documentation!

      -

      Next topic

      -

      Installation instructions

      -

      This Page

      - - - -
      -
      -
      -
      -
      -

      Navigation

      - -
      -
      - © Copyright 2014, Fco. de Borja Lopez Rio, Oscar M. Lage. - Created using Sphinx 1.2.2. -
      - - Index: cs/_build/html/genindex.html =================================================================== --- docs/_build/html/genindex.html (revision 42) +++ (revision ) @@ -1,93 +1,0 @@ - - - - - - - - - Index — Stamper 0.1 documentation - - - - - - - - - - - - -
      -

      Navigation

      - -
      - -
      -
      -
      -
      - - -

      Index

      - -
      - -
      - - -
      -
      -
      -
      -
      - - - - - -
      -
      -
      -
      -
      -

      Navigation

      - -
      -
      - © Copyright 2014, Fco. de Borja Lopez Rio, Oscar M. Lage. - Created using Sphinx 1.2.2. -
      - - Index: cs/_build/html/index.html =================================================================== --- docs/_build/html/index.html (revision 44) +++ (revision ) @@ -1,136 +1,0 @@ - - - - - - - - Welcome to Stamper’s documentation! — Stamper 0.1 documentation - - - - - - - - - - - - - -
      -

      Navigation

      - -
      - -
      -
      -
      -
      - -
      -

      Welcome to Stamper’s documentation!

      -

      This is the official documentation for Stamper, a time tracking tool written -in Python.

      -

      Contents:

      -
      - -
      -
      -
      -

      Indices and tables

      - -
      - - -
      -
      -
      -
      -
      -

      Table Of Contents

      - - -

      Next topic

      -

      About Stamper

      -

      This Page

      - - - -
      -
      -
      -
      -
      -

      Navigation

      - -
      -
      - © Copyright 2014, Fco. de Borja Lopez Rio, Oscar M. Lage. - Created using Sphinx 1.2.2. -
      - - Index: cs/_build/html/install.html =================================================================== --- docs/_build/html/install.html (revision 42) +++ (revision ) @@ -1,133 +1,0 @@ - - - - - - - - Installation instructions — Stamper 0.1 documentation - - - - - - - - - - - - - - -
      -

      Navigation

      - -
      - -
      -
      -
      -
      - -
      -

      Installation instructions

      -

      Installing Stamper is quite easy. If you have some experience installing -Python packages [1], you already know how to do it. Stamper is a standard -Python package available on pypi [2] so just use your favourite tool -(pip, easy_install, etc) to intall it:

      -
      pip install Stamper
-
      -
      -
      easy_install Stamper
-
      -
      -
      - - - - -
      [1]http://docs.python.org/tutorial/modules.html#packages
      - - - - - -
      [2]http://pypi.python.org/pypi/stamper
      - - - - - - -
      -
      -

      Previous topic

      -

      About Stamper

      -

      Next topic

      -

      How to use it

      -

      This Page

      - - - -
      -
      -
      - -
      -

      Navigation

      - -
      -
      - © Copyright 2014, Fco. de Borja Lopez Rio, Oscar M. Lage. - Created using Sphinx 1.2.2. -
      - - Index: cs/_build/html/search.html =================================================================== --- docs/_build/html/search.html (revision 42) +++ (revision ) @@ -1,100 +1,0 @@ - - - - - - - - Search — Stamper 0.1 documentation - - - - - - - - - - - - - - - - - - -
      -

      Navigation

      - -
      - -
      -
      -
      -
      - -

      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. -

      -
      - - - -
      - -
      - -
      - -
      -
      -
      -
      -
      -
      -
      -
      -
      -
      -

      Navigation

      - -
      -
      - © Copyright 2014, Fco. de Borja Lopez Rio, Oscar M. Lage. - Created using Sphinx 1.2.2. -
      - - Index: cs/_build/html/searchindex.js =================================================================== --- docs/_build/html/searchindex.js (revision 48) +++ (revision ) @@ -1,1 +1,0 @@ -Search.setIndex({envversion:42,terms:{all:3,code:1,identifi:[3,1],forget:1,just:[3,2],show:3,perl:1,text:[3,1],offici:0,verbos:[],becaus:1,interchang:1,human:1,follow:3,still:1,import_fil:[],languag:1,help:3,onli:3,slow:1,group:3,cli:3,easi:[1,2],also:3,graph:[],welter:1,ideal:1,littl:1,tail:1,program:1,dict:1,queri:1,save:[3,1],bebu:3,them:3,inspir:1,"return":3,string:3,get:[3,1],python:[0,1,2],familiar:1,pypi:2,dai:[],obtain:1,repo:3,know:2,instead:1,report:1,bar:3,bit:1,month:3,sascha:1,betabug:[3,1],magic:1,like:1,did:[3,1],list:[],entri:1,easili:1,statist:1,each:3,pars:1,januari:3,difficult:1,page:0,mean:1,subset:1,work:[3,1],timelin:[],some:[3,1,2],idea:1,born:1,cost:1,"export":1,result:3,year:3,extract:1,even:1,index:0,what:[3,1],insensit:3,"3rd":1,space:3,open:1,someth:1,calcul:1,per:[],workstamp:3,current:3,delet:[],written:[0,1],between:3,"import":1,experi:2,ref:3,can:[3,1],machin:1,afterward:1,full:[],august:3,usag:3,gener:[3,1],javascript:1,situat:3,here:1,standard:[1,2],base:[],nice:3,org:[1,2],sinc:3,search:0,last:3,convent:1,befor:3,keep:3,filter:[],etc:2,amount:1,tutori:2,fals:[],mani:1,chang:3,other:[3,1],ecma:1,first:3,origin:1,yyyi:3,rang:[],simpli:3,render:3,point:3,appli:3,modul:[0,2],independ:1,easy_instal:2,yourself:3,instruct:[],alreadi:[3,2],famili:1,instal:[],next:3,miss:3,your:[3,1,2],quit:[1,2],given:3,java:1,wai:3,stamp:[],custom:[3,1],avail:2,start:[3,1],call:3,editor:1,handl:3,txt:1,conveni:1,store:3,includ:1,tradit:1,head:1,option:[],name:3,juli:3,edit:1,ani:3,link:3,too:[],line:[3,1],those:[3,1],"case":3,notat:1,retriev:[],look:1,aka:1,provid:[3,1],intal:2,seealso:3,properti:1,onc:1,structur:1,cat:1,project:[3,1],matter:3,below:3,limit:3,whatev:1,learn:3,posit:[],more:3,similar:3,favourit:[1,2],have:[3,1,2],creat:3,certain:1,dure:3,argument:[],ugli:1,strongli:1,packag:2,exist:[],file:[3,1],lightweight:1,pip:2,dedic:1,check:1,again:[3,1],end:3,want:3,thing:3,perform:1,anoth:3,make:1,format:[3,1],when:[3,1],detail:[],same:3,date_based_filt:3,write:[3,1],how:[],need:1,html:2,take:3,varieti:1,test:3,record:[],you:[3,1,2],document:[],simpl:1,complet:1,week:3,finish:[3,1],http:[3,1,2],imagin:3,track:0,stop:3,symbol:3,after:3,chart:[],most:[3,1],date:[],data:1,implement:3,ago:3,task:[3,1],don:3,read:1,doc:[1,2],descript:[3,1],svg:3,object:1,without:3,inform:[],exampl:[3,1],command:3,thi:[0,1,3],time:[],far:3,programm:1,decemb:1,spent:1,sum:[],latest:3},objtypes:{},objnames:{},filenames:["index","about","install","using"],titles:["Welcome to Stamper’s documentation!","About Stamper","Installation instructions","How to use it"],objects:{},titleterms:{timelin:3,argument:3,indic:0,instruct:2,stamper:[0,1],exist:3,tabl:0,instal:2,total:3,from:[3,1],welcom:0,record:3,stamp:3,detail:3,per:3,content:[3,1],how:3,json:1,consecut:3,document:0,full:3,tool:1,time:3,dai:3,chart:3,base:3,date:3,come:1,about:1,retriev:3,list:3,doe:1,filter:3,inform:3,enter:1,where:1}}) Index: cs/_build/html/using.html =================================================================== --- docs/_build/html/using.html (revision 48) +++ (revision ) @@ -1,369 +1,0 @@ - - - - - - - - How to use it — Stamper 0.1 documentation - - - - - - - - - - - - - -
      -

      Navigation

      - -
      - -
      -
      -
      -
      - -
      -

      How to use it

      - -
      -

      Recording time

      -

      To start recording time:

      -
      stamp
-
      -
      -

      To stop recording time:

      -
      stamp ID DESCRIPTION
-
      -
      -

      where:

      -
        -
      • ID is a string without spaces identifying a customer, project, -group of tasks or any other thing you want to use to group your stamps
        • -
      • DESCRIPTION is a description of what you did
        • -
      -

      for example:

      -
      stamp stamper writing documentation
-
      -
      -

      or:

      -
      stamp stamper implementing per-month line charts
-
      -
      -
      -

      Recording consecutive stamps

      -

      Imagine you start working on a project, you stamp your start:

      -
      stamp
-
      -
      -

      and then you finish a given task, so you stamp it:

      -
      stamp stamper writing installation instructions
-
      -
      -

      but then, you keep yourself working on the same project, but on some other -task. You don’t have to stamp the start time again, you simply stamp again -when you finish the work on that other task:

      -
      stamp stamper writing usage instructions
-
      -
      -
      -

      Note

      -

      This apply also for changing to another project, you don’t have to stamp -the start time again, just keep stamping the end times. In such a situation, -Stamper will take the end time of a recorded stamp as the start time of the -next one.

      -
      -
      -
      -
      -

      Retrieving information from the existing stamps

      -
      -

      Total times

      -
        -

      • Get a list of total times stamped per ID:

        -
        stamps
-
        -
        -
        • -

      • Get the total times stamped for a given ID, for example, stamper:

        -
        stamps stamper
-
        -
        -
        • -

      • Get the total times stamped for the ID stamper during the last -week:

        -
        stamps stamper 1w
-
        -
        -
        -

        See also

        -

        1w is a date-based filter. You can learn more about those filters -in the Date-based filtering documentation below.

        -
        -
        • -
      -
      -
      -

      Per day details

      -
        -

      • Get a list of detailed per-day times:

        -
        stamps -v
-
        -
        -
        • -

      • Get details for a given ID, for example, stamper:

        -
        stamps -v stamper
-
        -
        -
        • -

      • Get details for a given month, for example, august 2014:

        -
        stamps -v 2014-08-01--2014-09-01
-
        -
        -
        -

        See also

        -

        2014-08-01–2014-09-01 is a date-based filter. You can learn more about -those filters in the Date-based filtering documentation below.

        -
        -
        • -
      -
      -
      -

      Timeline

      -

      You can get a timeline of all the stamped stamps:

      -
      stamps -t
-
      -
      -

      This timeline will show each stamp in a line, in a similar way to what bebu’s -stamp [1] stores in its text-based file:

      -
      2014-08-12 12:33 start
-2014-08-12 12:51 stamper writing installation instructions
-2014-08-12 13:11 stamper writing usage documentation
-2014-08-13 09:33 start
-2014-08-13 12:12 stamper adding missing tests for the cli tools
-
      -
      -

      You can filter the timeline by ID:

      -
      stamps -t stamper
-
      -
      -

      And/or by date:

      -
      stamps -t 2m
-
-.. seealso::
-
-   *2m* is a date-based filter. You can learn more about those filters
-   in the :ref:`date_based_filtering` documentation below.
-
      -
      -
      -
      -

      Charts

      -

      You can generate some nice charts from your stamps. So far only bar charts -showing the total time per day can be generated, but you can filter them by -ID and/or date. Some examples:

      -
        -

      • Render a chart of all the times already stamped, by ID:

        -
        stamps -g
-
        -
        -
        • -

      • Render a chart of the stamps for the last 4 days:

        -
        stamps -g 4d
-
        -
        -
        • -

      • Render a chart of the stamps for the ID stamper for the last week:

        -
        stamps -g stamper 1w
-
        -
        -
        • -
      -
      -

      Note

      -

      The charts will be saved into ~/.workstamps-charts, in SVG format. -The name of the chart will be generated based on the current date and -time, and a symbolic link called chart-latest.svg will be created, -pointing to the latest chart generated.

      -
      -
      -
      -
      -

      stamps - full List of arguments

      -

      You can get the full list of arguments from the command line:

      -
      stamps -h
-
      -
      -

      or:

      -
      stamps --help
-
      -
      -
      -
      -

      Date-based filtering

      -

      Most of the results returned by the stamps tool can be filtered using the -following date-based filters:

      -
        -

      • YYYY-MM-DD: Limit the results to only those stamps stamped on this date:

        -
        stamps -v 2014-08-13
-
        -
        -
        stamps -t stamper 2014-08-13
-
        -
        -
        • -

      • YYYY-MM-DD*: Limit the results to only those stamps stamped after this -date. For example, this will show per-day details for stamps stamped after -the first of august, 2014:

        -
        stamps -v 2014-08-01*
-
        -
        -
        • -

      • *YYYY-MM-DD: Limit the results to only those stamps stamped before this -date. For example this will show the total time stamped for project stamper -before the first of january, 2014:

        -
        stamps stamper *2014-01-01
-
        -
        -
        • -

      • YYYY-MM-DD–YYYY-MM-DD: Limit the results to only those stamps stamped in -a date between those dates. For example, this will show the timeline for -july, 2014:

        -
        stamps -t 2014-07-01--2014-08-01
-
        -
        -
        • -

      • nD|W|M|Y: Limit the results to only those stamps stamped since n days -(D), weeks (W), months (M) or years (Y) ago. -For example, this will show the details for the last month:

        -
        stamps -v 1m
-
        -
        -
        -

        Note

        -

        It does not matter if you provide d|w|m|y or D|W|M|Y. The filters are -handled in a case-insensitive way.

        -
        -
        • -
      - - - - - -
      [1]http://repos.betabug.ch/stamp
      -
      -
      - - -
      -
      -
      -
      -
      -

      Table Of Contents

      - - -

      Previous topic

      -

      Installation instructions

      -

      This Page

      - - - -
      -
      -
      -
      -
      -

      Navigation

      - -
      -
      - © Copyright 2014, Fco. de Borja Lopez Rio, Oscar M. Lage. - Created using Sphinx 1.2.2. -
      - - Index: cs/about.rst =================================================================== --- docs/about.rst (revision 42) +++ (revision ) @@ -1,85 +1,0 @@ -About Stamper -============= - -.. contents:: - - -From where does it come from? ------------------------------ - -Stamper_ was born strongly inspired by the original stamp_ tool written by -`Sascha Welter`_ (aka betabug_). - -The idea is quite simple: - -1. You **stamp** a time in a text file, recording that time as the time when - you started working on something:: - - 2014-08-13 09:45 start - -2. You **stamp** again once you have finished, providing something like an id - (to identify a customer, project, whatever) and a description of what you - did:: - - 2014-08-13 10:45 stamper writing documentation - -Those times are saved into a text file and afterwards, with a little bit of -python_ magic, you get some reports about the amount of time dedicated per -day or id (for example). - - -Enter the JSON --------------- - -Betabug's stamp tool records those times as lines in a text file. This is quite -convenient because you can look into the file with traditional tools like *cat*, -*head* or *tail*, or even open it with your favourite editor, and get -information about the times you've spent working on something. - -But this comes *at a cost*, it needs some *ugly* parsing of the .txt file in the -python code that calculates the statistics and reports, making it difficult/slow -to perform certain tasks. - -**And here it comes JSON:** - -:: - - JSON (JavaScript Object Notation) is a lightweight data-interchange format. - It is easy for humans to read and write. It is easy for machines to parse - and generate. It is based on a subset of the JavaScript Programming Language, - Standard ECMA-262 3rd Edition - December 1999. JSON is a text format that is - completely language independent but uses conventions that are familiar to - programmers of the C-family of languages, including C, C++, C#, Java, - JavaScript, Perl, Python, and many others. These properties make JSON an - ideal data-interchange language. - -(extracted from http://json.org) - -Using a .json file instead of a txt file, we can export/import python data -structures (like lists or dicts) easily into a text-like file. This means that -we can still edit the file using a text editor, or check its contents using -*cat*, *head* or *tail*, but we can forget about the parsing of the entries. - - -The tools ---------- - -Stamper_ comes with a variety of tools, but the most used ones are: - -- **stamp:** Use this to *stamp* times into the json file. - -- **stamps:** USe this to query the json file and obtain information about your - stamped times. - -.. seealso:: - - :doc:using - - - -.. _Stamper: https://bitbucket.org/codigo23/stamper -.. _stamp: http://repos.betabug.ch/stamp -.. _`Sascha Welter`: http://betabug.ch -.. _`betabug`: http://betabug.ch -.. _python: http://python.org -.. _JSON: Index: cs/conf.py =================================================================== --- docs/conf.py (revision 47) +++ (revision ) @@ -1,339 +1,0 @@ -# -*- coding: utf-8 -*- -# -# Stamper documentation build configuration file, created by -# sphinx-quickstart on Wed Aug 13 21:25:05 2014. -# -# This file is execfile()d with the current directory set to its -# containing dir. -# -# Note that not all possible configuration values are present in this -# autogenerated file. -# -# All configuration values have a default; values that are commented out -# serve to show the default. - -import sys -import os - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -#sys.path.insert(0, os.path.abspath('.')) - -# -- General configuration ------------------------------------------------ - -# If your documentation needs a minimal Sphinx version, state it here. -#needs_sphinx = '1.0' - -# Add any Sphinx extension module names here, as strings. They can be -# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom -# ones. -extensions = [ - 'sphinx.ext.autodoc', - 'sphinx.ext.intersphinx', - 'sphinx.ext.todo', - 'sphinx.ext.ifconfig', - 'sphinx.ext.viewcode', - #'sphinxarg.ext' -] - -# Add any paths that contain templates here, relative to this directory. -templates_path = ['_templates'] - -# The suffix of source filenames. -source_suffix = '.rst' - -# The encoding of source files. -#source_encoding = 'utf-8-sig' - -# The master toctree document. -master_doc = 'index' - -# General information about the project. -project = u'Stamper' -copyright = u'2014, Fco. de Borja Lopez Rio, Oscar M. Lage' - -# The version info for the project you're documenting, acts as replacement for -# |version| and |release|, also used in various other places throughout the -# built documents. -# -# The short X.Y version. -version = '0.1' -# The full version, including alpha/beta/rc tags. -release = '0.1' - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -#language = None - -# There are two options for replacing |today|: either, you set today to some -# non-false value, then it is used: -#today = '' -# Else, today_fmt is used as the format for a strftime call. -#today_fmt = '%B %d, %Y' - -# List of patterns, relative to source directory, that match files and -# directories to ignore when looking for source files. -exclude_patterns = ['_build'] - -# The reST default role (used for this markup: `text`) to use for all -# documents. -#default_role = None - -# If true, '()' will be appended to :func: etc. cross-reference text. -#add_function_parentheses = True - -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -#add_module_names = True - -# If true, sectionauthor and moduleauthor directives will be shown in the -# output. They are ignored by default. -#show_authors = False - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' - -# A list of ignored prefixes for module index sorting. -#modindex_common_prefix = [] - -# If true, keep warnings as "system message" paragraphs in the built documents. -#keep_warnings = False - - -# -- Options for HTML output ---------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -html_theme = 'default' - -# Theme options are theme-specific and customize the look and feel of a theme -# further. For a list of options available for each theme, see the -# documentation. -#html_theme_options = {} - -# Add any paths that contain custom themes here, relative to this directory. -#html_theme_path = [] - -# The name for this set of Sphinx documents. If None, it defaults to -# " v documentation". -#html_title = None - -# A shorter title for the navigation bar. Default is the same as html_title. -#html_short_title = None - -# The name of an image file (relative to this directory) to place at the top -# of the sidebar. -#html_logo = None - -# The name of an image file (within the static path) to use as favicon of the -# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 -# pixels large. -#html_favicon = None - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] - -# Add any extra paths that contain custom files (such as robots.txt or -# .htaccess) here, relative to this directory. These files are copied -# directly to the root of the documentation. -#html_extra_path = [] - -# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, -# using the given strftime format. -#html_last_updated_fmt = '%b %d, %Y' - -# If true, SmartyPants will be used to convert quotes and dashes to -# typographically correct entities. -#html_use_smartypants = True - -# Custom sidebar templates, maps document names to template names. -#html_sidebars = {} - -# Additional templates that should be rendered to pages, maps page names to -# template names. -#html_additional_pages = {} - -# If false, no module index is generated. -#html_domain_indices = True - -# If false, no index is generated. -#html_use_index = True - -# If true, the index is split into individual pages for each letter. -#html_split_index = False - -# If true, links to the reST sources are added to the pages. -#html_show_sourcelink = True - -# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. -#html_show_sphinx = True - -# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. -#html_show_copyright = True - -# If true, an OpenSearch description file will be output, and all pages will -# contain a tag referring to it. The value of this option must be the -# base URL from which the finished HTML is served. -#html_use_opensearch = '' - -# This is the file name suffix for HTML files (e.g. ".xhtml"). -#html_file_suffix = None - -# Output file base name for HTML help builder. -htmlhelp_basename = 'Stamperdoc' - - -# -- Options for LaTeX output --------------------------------------------- - -latex_elements = { -# The paper size ('letterpaper' or 'a4paper'). -#'papersize': 'letterpaper', - -# The font size ('10pt', '11pt' or '12pt'). -#'pointsize': '10pt', - -# Additional stuff for the LaTeX preamble. -#'preamble': '', -} - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, -# author, documentclass [howto, manual, or own class]). -latex_documents = [ - ('index', 'Stamper.tex', u'Stamper Documentation', - u'Fco. de Borja Lopez Rio, Oscar M. Lage', 'manual'), -] - -# The name of an image file (relative to this directory) to place at the top of -# the title page. -#latex_logo = None - -# For "manual" documents, if this is true, then toplevel headings are parts, -# not chapters. -#latex_use_parts = False - -# If true, show page references after internal links. -#latex_show_pagerefs = False - -# If true, show URL addresses after external links. -#latex_show_urls = False - -# Documents to append as an appendix to all manuals. -#latex_appendices = [] - -# If false, no module index is generated. -#latex_domain_indices = True - - -# -- Options for manual page output --------------------------------------- - -# One entry per manual page. List of tuples -# (source start file, name, description, authors, manual section). -man_pages = [ - ('index', 'stamper', u'Stamper Documentation', - [u'Fco. de Borja Lopez Rio, Oscar M. Lage'], 1) -] - -# If true, show URL addresses after external links. -#man_show_urls = False - - -# -- Options for Texinfo output ------------------------------------------- - -# Grouping the document tree into Texinfo files. List of tuples -# (source start file, target name, title, author, -# dir menu entry, description, category) -texinfo_documents = [ - ('index', 'Stamper', u'Stamper Documentation', - u'Fco. de Borja Lopez Rio, Oscar M. Lage', 'Stamper', 'One line description of project.', - 'Miscellaneous'), -] - -# Documents to append as an appendix to all manuals. -#texinfo_appendices = [] - -# If false, no module index is generated. -#texinfo_domain_indices = True - -# How to display URL addresses: 'footnote', 'no', or 'inline'. -#texinfo_show_urls = 'footnote' - -# If true, do not generate a @detailmenu in the "Top" node's menu. -#texinfo_no_detailmenu = False - - -# -- Options for Epub output ---------------------------------------------- - -# Bibliographic Dublin Core info. -epub_title = u'Stamper' -epub_author = u'Fco. de Borja Lopez Rio, Oscar M. Lage' -epub_publisher = u'Fco. de Borja Lopez Rio, Oscar M. Lage' -epub_copyright = u'2014, Fco. de Borja Lopez Rio, Oscar M. Lage' - -# The basename for the epub file. It defaults to the project name. -#epub_basename = u'Stamper' - -# The HTML theme for the epub output. Since the default themes are not optimized -# for small screen space, using the same theme for HTML and epub output is -# usually not wise. This defaults to 'epub', a theme designed to save visual -# space. -#epub_theme = 'epub' - -# The language of the text. It defaults to the language option -# or en if the language is not set. -#epub_language = '' - -# The scheme of the identifier. Typical schemes are ISBN or URL. -#epub_scheme = '' - -# The unique identifier of the text. This can be a ISBN number -# or the project homepage. -#epub_identifier = '' - -# A unique identification for the text. -#epub_uid = '' - -# A tuple containing the cover image and cover page html template filenames. -#epub_cover = () - -# A sequence of (type, uri, title) tuples for the guide element of content.opf. -#epub_guide = () - -# HTML files that should be inserted before the pages created by sphinx. -# The format is a list of tuples containing the path and title. -#epub_pre_files = [] - -# HTML files shat should be inserted after the pages created by sphinx. -# The format is a list of tuples containing the path and title. -#epub_post_files = [] - -# A list of files that should not be packed into the epub file. -epub_exclude_files = ['search.html'] - -# The depth of the table of contents in toc.ncx. -#epub_tocdepth = 3 - -# Allow duplicate toc entries. -#epub_tocdup = True - -# Choose between 'default' and 'includehidden'. -#epub_tocscope = 'default' - -# Fix unsupported image types using the PIL. -#epub_fix_images = False - -# Scale large images. -#epub_max_image_width = 0 - -# How to display URL addresses: 'footnote', 'no', or 'inline'. -#epub_show_urls = 'inline' - -# If false, no index is generated. -#epub_use_index = True - - -# Example configuration for intersphinx: refer to the Python standard library. -intersphinx_mapping = {'http://docs.python.org/': None} Index: cs/index.rst =================================================================== --- docs/index.rst (revision 42) +++ (revision ) @@ -1,31 +1,0 @@ -.. Stamper documentation master file, created by - sphinx-quickstart on Wed Aug 13 21:25:05 2014. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to Stamper's documentation! -=================================== - -This is the official documentation for Stamper_, a *time tracking* tool written -in Python_. - -Contents: - -.. toctree:: - :maxdepth: 2 - - about - install - using - - - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - -.. _Stamper: https://bitbucket.org/codigo23/stamper -.. _Python: http://python.org Index: cs/install.rst =================================================================== --- docs/install.rst (revision 73) +++ (revision ) @@ -1,28 +1,0 @@ -Installation instructions -========================= - -Installing Stamper_ is quite easy. If you have some experience installing -Python_ packages [1]_, you already know how to do it. Stamper is a standard -Python_ package available on pypi_ [2]_ so just use your favourite tool -(pip_, easy_install_, etc) to intall it:: - - pip install Stamper - -You can also grab the latest sources from the project main repository -(Mercurial_) at https://code.codigo23.net/hg/stamper:: - - hg clone https://code.codigo23.net/hg/stamper - -And install it from there (development mode):: - - pip install -e /PATH/TO/STAMPER-CLONE - - -.. _Stamper: https://bitbucket.org/codigo23/stamper -.. _Python: http://python.org -.. _pip: http://www.pip-installer.org/en/latest/index.html -.. _pypi: http://pypi.python.org/pypi -.. _Mercurial: https://www.mercurial-scm.org - -.. [1] http://docs.python.org/tutorial/modules.html#packages -.. [2] http://pypi.python.org/pypi/stamper Index: cs/using.rst =================================================================== --- docs/using.rst (revision 48) +++ (revision ) @@ -1,221 +1,0 @@ -How to use it -============= - -.. contents:: - - -Recording time --------------- - -To start recording time:: - - stamp - -To stop recording time:: - - stamp ID DESCRIPTION - -where: - -- **ID** is a string **without spaces** identifying a customer, project, - group of tasks or any other thing you want to use to group your stamps - -- **DESCRIPTION** is a description of what you did - -for example:: - - stamp stamper writing documentation - -or:: - - stamp stamper implementing per-month line charts - - -Recording consecutive stamps -++++++++++++++++++++++++++++ - -Imagine you start working on a project, you *stamp* your start:: - - stamp - -and then you finish a given task, so you *stamp* it:: - - stamp stamper writing installation instructions - -but then, you keep yourself working on the same project, but on some other -task. You don't have to *stamp* the start time again, you simply *stamp* again -when you finish the work on that other task:: - - stamp stamper writing usage instructions - -.. note:: - - This apply also for changing to another project, you don't have to *stamp* - the start time again, just keep stamping the end times. In such a situation, - Stamper will take the end time of a recorded stamp as the start time of the - next one. - - -Retrieving information from the existing stamps ------------------------------------------------ - -Total times -+++++++++++ - -- Get a list of total times stamped per **ID**:: - - stamps - -- Get the total times stamped for a given **ID**, for example, **stamper**:: - - stamps stamper - -- Get the total times stamped for the **ID** **stamper** during the last - week:: - - stamps stamper 1w - - .. seealso:: - - *1w* is a date-based filter. You can learn more about those filters - in the :ref:`date_based_filtering` documentation below. - -Per day details -+++++++++++++++ - -- Get a list of detailed per-day times:: - - stamps -v - -- Get details for a given **ID**, for example, **stamper**:: - - stamps -v stamper - -- Get details for a given month, for example, *august 2014*:: - - stamps -v 2014-08-01--2014-09-01 - - .. seealso:: - - *2014-08-01--2014-09-01* is a date-based filter. You can learn more about - those filters in the :ref:`date_based_filtering` documentation below. - -Timeline -++++++++ - -You can get a *timeline* of all the stamped stamps:: - - stamps -t - -This *timeline* will show each stamp in a line, in a similar way to what bebu's -stamp [1]_ stores in its text-based file:: - - 2014-08-12 12:33 start - 2014-08-12 12:51 stamper writing installation instructions - 2014-08-12 13:11 stamper writing usage documentation - 2014-08-13 09:33 start - 2014-08-13 12:12 stamper adding missing tests for the cli tools - -You can filter the timeline by **ID**:: - - stamps -t stamper - -And/or by date:: - - stamps -t 2m - - .. seealso:: - - *2m* is a date-based filter. You can learn more about those filters - in the :ref:`date_based_filtering` documentation below. - - -Charts -++++++ - -You can generate some nice charts from your stamps. So far only bar charts -showing the total time per day can be generated, but you can filter them by -**ID** and/or date. Some examples: - -- Render a chart of all the times already stamped, by **ID**:: - - stamps -g - -- Render a chart of the stamps for the last 4 days:: - - stamps -g 4d - -- Render a chart of the stamps for the **ID** *stamper* for the last week:: - - stamps -g stamper 1w - -.. note:: - - The charts will be saved into **~/.workstamps-charts**, in SVG_ format. - The name of the chart will be generated based on the current date and - time, and a *symbolic link* called **chart-latest.svg** will be created, - pointing to the latest chart generated. - - -stamps - full List of arguments -------------------------------- - -You can get the full list of arguments from the command line:: - - stamps -h - -or:: - - stamps --help - - - -.. _date_based_filtering: - -Date-based filtering --------------------- - -Most of the results returned by the *stamps* tool can be filtered using the -following date-based filters: - -- **YYYY-MM-DD**: Limit the results to only those stamps stamped on this date:: - - stamps -v 2014-08-13 - - :: - - stamps -t stamper 2014-08-13 - -- **YYYY-MM-DD\***: Limit the results to only those stamps stamped **after this - date**. For example, this will show per-day details for stamps stamped after - the first of august, 2014:: - - stamps -v 2014-08-01* - -- **\*YYYY-MM-DD**: Limit the results to only those stamps stamped **before this - date**. For example this will show the total time stamped for project stamper - before the first of january, 2014:: - - stamps stamper *2014-01-01 - -- **YYYY-MM-DD--YYYY-MM-DD**: Limit the results to only those stamps stamped in - a date **between those dates**. For example, this will show the *timeline* for - july, 2014:: - - stamps -t 2014-07-01--2014-08-01 - -- **nD|W|M|Y**: Limit the results to only those stamps stamped since n *days* - (**D**), *weeks* (**W**), *months* (**M**) or *years* (**Y**) ago. - For example, this will show the details for the last month:: - - stamps -v 1m - - .. note:: - - It does not matter if you provide *d|w|m|y* or *D|W|M|Y*. The filters are - handled in a case-insensitive way. - - -.. _SVG: http://en.wikipedia.org/wiki/Scalable_Vector_Graphics - -.. [1] http://repos.betabug.ch/stamp Index: c/stamper.conf =================================================================== --- etc/stamper.conf (revision 68) +++ (revision ) @@ -1,22 +1,0 @@ -# -# stamper.conf - Stamper configuration file -# - -[stamps] -path = ~/.workstamps.json -date_format = %%Y-%%m-%%d -time_format = %%H:%%M:%%S -datetime_format = %%Y-%%m-%%d %%H:%%M -wants_seconds = false - -[sum] -hours_day = 8 - -[charts] -path = ~/.workstamps-charts - -[collector] -base_url = http://localhost:8000 -login_path = /stamper/login/ -user = CHANGEME -password = SECRET Index: setup.py =================================================================== --- setup.py (revision 72) +++ setup.py (revision 0) @@ -1,32 +1,28 @@ import os +import setuptools +from distutils.core import setup -from setuptools import setup - -version = '0.1.1' - -requires = [ - 'pygal' -] setup( name='stamper', - version=version, + version='0.0.1', author='Francisco de Borja Lopez Rio', author_email='borja@codigo23.net', packages=['stamper'], - url='https://code.codigo23.net/trac/wiki/stamper', + url='https://bitbucket.org/codigo23/stamper', download_url='http://pypi.python.org/pypi/stamper#downloads', license='BSD licence, see LICENSE', description='Time tracking tool', - long_description=open('README.rst').read(), - scripts=['bin/stamp', 'bin/stamps', 'bin/stamp2json', 'bin/time_sum'], - install_requires=requires, + long_description=open('README').read(), + scripts=['bin/stamp', 'bin/calc'], classifiers=[ - 'Development Status :: 4 - Beta', + 'Development Status :: 3 - Alpha', 'Environment :: Console', + 'Environment :: No Input/Output (Daemon)', 'Intended Audience :: End Users/Desktop', 'License :: OSI Approved :: BSD License', 'Natural Language :: English', 'Operating System :: OS Independent', + 'Programming Language :: Python :: 2', 'Programming Language :: Python :: 3', 'Topic :: Office/Business', Index: stamper/__init__.py =================================================================== --- stamper/__init__.py (revision 71) +++ stamper/__init__.py (revision 0) @@ -1,1 +1,1 @@ - +from stamper import Stamper Index: amper/cli.py =================================================================== --- stamper/cli.py (revision 61) +++ (revision ) @@ -1,27 +1,0 @@ -import argparse - - -def build_args_parser(): - parser = argparse.ArgumentParser( - description='stamps: show recorded times information') - parser.add_argument('customer', action="store", nargs='?', - help='Show times only for this customer') - parser.add_argument('filter', action="store", nargs='?', - help='Filter the times by date range') - parser.add_argument('-v', '--verbose', action="store_true", - help='Include detailed times information') - parser.add_argument('-s', '--sum', action="store_true", - help='Include sum of times') - parser.add_argument('-g', '--graph', action="store_true", - help='Generate a SVG graph') - parser.add_argument('-t', '--timeline', action="store_true", - help='Show a timeline of recorded times') - parser.add_argument('-desc', '--description', action="store", - help='Filter results by the description in the stamp') - parser.add_argument('-d', '--delete', action="store", type=int, - help='Delete up to n recorded stamps') - parser.add_argument('-i', '--import', action="store", dest="import_file", - help='Import stamps from the given file') - parser.add_argument('-p', '--push', action="store_true", - help='Push stamps to a remote stamps collector server') - return parser Index: amper/config.py =================================================================== --- stamper/config.py (revision 71) +++ (revision ) @@ -1,62 +1,0 @@ - -import os -from configparser import SafeConfigParser - - -class Config(object): - def __init__(self, path=None): - self.path = path - self.default_paths = [ - os.path.expanduser('~/'), - os.path.join(os.path.dirname(__file__),'../etc') - ] - self.config = {} - - @property - def filename(self): - return 'stamper.conf' - - @property - def sections(self): - return['stamps', 'sum', 'charts', 'collector'] - - def look_for_config(self): - """ - Look for the configuration file, following the path names listed in - the default paths - """ - for path in self.default_paths: - full_path = os.path.join(path, self.filename) - if os.path.isfile(full_path): - self.path = full_path - return full_path - # if we reach here, self.path will be still None, no valid - # config files were found, and so we raise an exception - raise IOError('ERROR - Can not find ' + self.filename + \ - ' in your environment') - - def load(self): - if not self.path: - full_path = self.look_for_config() - parser = SafeConfigParser() - parser.read(full_path) - for section in self.sections: - self.config[section] = {} - for name, value in parser.items(section): - self.config[section][name] = value - return self.config - - def get(self, section, parameter=None): - if section not in self.config.keys(): - # perhaps the config hasn't been loaded yet - self.load() - - if section not in self.sections: - raise IndexError('ERROR - ' + section + \ - ' is not one of the available sections: ' + \ - ', '.join(self.sections)) - - if parameter: - return self.config[section][parameter] - - return self.config[section] Index: amper/filters.py =================================================================== --- stamper/filters.py (revision 66) +++ (revision ) @@ -1,191 +1,0 @@ - -import re -from datetime import datetime, date, timedelta - - -class DateFilter(object): - - """ - Filtering tools for the dates input provided by the user - """ - - def __init__(self, date_format): - self.date_format = date_format - - def days(self, current_date, days, action='-'): - """ - Add/substract the given number of days from the given current_date - """ - delta = timedelta(days=days) - if action == '-': - new_date = current_date - delta - else: - new_date = current_date + delta - new_date = new_date.replace(hour=0, minute=0, second=0) - return new_date - - def days_ago(self, current_date, days): - """ - Return the date N days ago from the current date - """ - return self.days(current_date, days, '-') - - def days_future(self, current_date, days): - """ - Return the date N days in the future from the current date - """ - return self.days(current_date, days, '+') - - def months(self, current_date, months, action='-'): - """ - Add/substract the given number of months from the given current_date - """ - if action == '-': - # start travelling in time, back to N months ago - for n in range(months): - current_date = current_date.replace(day=1) - timedelta(days=1) - else: - # start travelling in time, forward to N months - for n in range(months): - current_date = current_date.replace(day=1) + timedelta(days=1) - - # Now use the new year/month values + the current day to set the proper - # date - new_date = datetime( - current_date.year, current_date.month, date.today().day) - return new_date - - def months_ago(self, current_date, months): - """ - Return the date N days ago from the current date - """ - return self.months(current_date, months, '-') - - def months_future(self, current_date, months): - """ - Return the date N days in the future from the current date - """ - return self.months(current_date, months, '+') - - def parse_number_filter(self, number_filter, start_date=None, - future=False): - """ - Given a numeric filter with the N[d|w|m|y] pattern, return both - the number of days/months/years that apply as a filter, + the - date N[d|w|m|y] ago from start_date (which defaults to today if - None is passed). - - If future is True, it will return a date in the future, not from - the past. - """ - number = None - filtered_date = None - start_date = start_date or datetime.today() - - # set which methods use to process the date, going backwards into the - # past as a default, unless we are told otherwise - filter_days = self.days_ago - filter_months = self.months_ago - if future: - filter_days = self.days_future - filter_months = self.months_future - - if re.search(r'(\d+[dD]{1})', number_filter): - number = int(number_filter.lower().replace('d', '')) - filtered_date = filter_days(start_date, number) - - elif re.search(r'(\d+[wW]{1})', number_filter): - number = int(number_filter.lower().replace('w', '')) * 7 - filtered_date = filter_days(start_date, number) - - elif re.search(r'(\d+[mM]{1})', number_filter): - number = int(number_filter.lower().replace('m', '')) - filtered_date = filter_months(start_date, number) - - elif re.search(r'(\d+[yY]{1})', number_filter): - number = int(number_filter.lower().replace('y', '')) - today = date.today() - # by default assume going backwards into the past... - year = today.year - number - if future: - #...unless told otherwise - year = today.year + number - filtered_date = datetime(year, today.month, today.day) - - return number, filtered_date - - def validate(self, stamp_filter): - """ - Validate a given filter. Filters can have the following notation: - - - %Y-%m-%d: Times recorded at a given date - - - %Y-%m-%d--%Y-%m-%d: Times recorded between two dates - - - *%Y-%m-%d: Times recorded up to a given date - - - %Y-%m-%d*: Times recorded from a given date - - - %Y-%m-%d+sN[d|w|m|y]: Times recorded since the given date up to - N more days/weeks/months/years - - - N...N[d|w|m|y]: Times recorded N...N days/weeks/months/years ago - - Important: all date comparisons are made on datetime objects, using - 00:00 as the time (first second of the given day). This means that - for range filters, the first day is included, but the second day is not - """ - filter_from = None - filter_to = None - - if stamp_filter is None: - return filter_from, filter_to - - if '--' in stamp_filter: - filter_from, filter_to = stamp_filter.split('--') - filter_from = datetime.strptime(filter_from, self.date_format) - filter_to = datetime.strptime(filter_to, self.date_format) - - elif stamp_filter.startswith('*'): - filter_to = datetime.strptime(stamp_filter, '*'+self.date_format) - filter_to = filter_to.replace(hour=0, minute=0, second=0) - - elif stamp_filter.endswith('*'): - filter_from = datetime.strptime(stamp_filter, self.date_format+'*') - filter_from = filter_from.replace(hour=0, minute=0, second=0) - - elif '+' in stamp_filter: - # "+" filtering works with a date following by "+", a number and - # a letter (d|w|m|y) which sets the number of days, weeks, months, - # years we would like to go into the future - filter_from, number = stamp_filter.split('+') - filter_from = datetime.strptime(filter_from, self.date_format) - number, filter_to = self.parse_number_filter( - number, filter_from, future=True) - - elif stamp_filter.count('-') == 3: - # "-" filtering works with a date followed by "-", a number and - # a letter (d|w|m|y) which sets the number of days, weeks, months, - # years we would like to go backwards into the past - year, month, day, number = stamp_filter.split('-') - filter_to = '-'.join([year, month, day]) - filter_to = datetime.strptime(filter_to, self.date_format) - number, filter_from = self.parse_number_filter(number, filter_to) - - else: - # Check if the user is asking for N days/weeks/months/years - number, filter_from = self.parse_number_filter(stamp_filter) - if number is None: - # no filtering found, maybe they are giving us a fixed date - try: - filter_from = datetime.strptime(stamp_filter, - self.date_format) - except: - # nothing to be used as a filter, go on, printing a warning - print('[warning] invalid date filter: ' + stamp_filter) - else: - filter_from = filter_from.replace(hour=0, minute=0, - second=0) - filter_to = filter_from + timedelta(days=1) - - return filter_from, filter_to Index: amper/http.py =================================================================== --- stamper/http.py (revision 71) +++ (revision ) @@ -1,26 +1,0 @@ - -import http.client -from urllib.parse import urlparse, urlencode, quote_plus - - -class HTTPClient(object): - - def __init__(self, base_url): - self.parsed_url = urlparse(base_url) - if self.parsed_url.scheme == 'https': - self.conn = http.client.HTTPSConnection(self.parsed_url.netloc) - else: - self.conn = http.client.HTTPConnection(self.parsed_url.netloc) - - def get(self, url): - self.conn.request('GET', url) - response = conn.getresponse() - return response.read() - - def post(self, url, data): - encoded_data = urlencode(data, quote_via=quote_plus) - headers = {'Content-type': 'application/x-www-form-urlencoded', - 'Accept': 'text/plain'} - self.conn.request('POST', url, encoded_data, headers) - response = conn.getresponse() - return response.read() Index: stamper/stamper.py =================================================================== --- stamper/stamper.py (revision 75) +++ stamper/stamper.py (revision 0) @@ -1,81 +1,29 @@ import json -import os.path from datetime import datetime, timedelta -from os import symlink, remove, makedirs -from collections import OrderedDict -from operator import itemgetter -import pygal +from os.path import expanduser, exists -from .http import HTTPClient -from .config import Config -from .filters import DateFilter - - -def timedelta_to_hms(value): - """ - Return hours, minutes, seconds from a timedelta object - """ - hours, remainder = divmod(int(value.total_seconds()), 3600) - minutes, seconds = divmod(remainder, 60) - return hours, minutes, seconds +STAMPS_FILE = expanduser('~/.workstamps.json') +DATE_FORMAT = '%Y-%m-%d %H:%M:%S' class Stamper(object): - def __init__(self, config_file=None): - self.config = Config(config_file) - self.stamps_file = os.path.expanduser( - self.config.get('stamps', 'path')) - self.charts_dir = os.path.expanduser( - self.config.get('charts', 'path')) - self.date_format = self.config.get('stamps', 'date_format') - self.time_format = self.config.get('stamps', 'time_format') - self.datetime_format = self.config.get('stamps', 'datetime_format') - self.wants_seconds = self.config.get('stamps', 'wants_seconds') - self.hours_day = int(self.config.get('sum', 'hours_day')) - self.collector = self.config.get('collector') + def __init__(self, stamps_file=STAMPS_FILE): + self.stamps_file = STAMPS_FILE self.ensure_stamps_file() - self.ensure_charts_dir() self.stamps = [] - self.date_filter = DateFilter(self.date_format) - - def __json_load(self, filename): - """ - Load the stamps from a file in json format, returning - the parsed list. - """ - with open(filename, 'r') as stamps_file: - try: - stamps = json.load(stamps_file) - except ValueError: - stamps = [] - return stamps - - def remove_duplicates(self): - """ - Remove duplicated stamps from the stamps list - """ - stamps = [dict(t) for t in set( - [tuple(d.items()) for d in self.stamps])] - self.stamps = stamps def ensure_stamps_file(self): - if not os.path.exists(self.stamps_file): + if not exists(self.stamps_file): with open(self.stamps_file, 'w') as stamps_file: stamps_file.write('') - def ensure_charts_dir(self): - if not os.path.exists(self.charts_dir): - makedirs(self.charts_dir) - def load_stamps(self): - self.stamps = self.__json_load(self.stamps_file) - - def sort_stamps(self): - """ - Sort all the stamps by start and end dates - """ - self.stamps = sorted(self.stamps, key=itemgetter('start', 'end')) + with open(self.stamps_file, 'r') as stamps_file: + try: + self.stamps = json.load(stamps_file) + except ValueError: + self.stamps = [] def save_stamps(self): @@ -91,19 +39,14 @@ }) - def last_stamp(self, n=1): - """ - return the stamp in position -n, that is, starting from the latest one - and going back N positions in the list of stamps - """ + def last_stamp(self): if not self.stamps: return None - return self.stamps[-n] + return self.stamps[-1] def worktime(self, start, end): - worktime = (datetime.strptime(end, self.datetime_format) - - datetime.strptime(start, self.datetime_format)) + worktime = (datetime.strptime(end, DATE_FORMAT) - + datetime.strptime(start, DATE_FORMAT)) return worktime.seconds - @property def customers(self): customers = [] @@ -114,54 +57,24 @@ return customers - def totals(self, filter_from=None, filter_to=None, filter_descr=None): + def total_by_customer(self, customer): + total = 0 + for stamp in self.stamps: + if stamp['customer'] == customer: + total += self.worktime(stamp['start'], stamp['end']) + total = timedelta(seconds=total) + return str(total) + + def totals(self): + totals = {} + for customer in self.customers(): + totals[customer] = self.total_by_customer(customer) + return totals + + def details_by_customer(self, customer): + details = {} totals = {} for stamp in self.stamps: - customer = stamp['customer'] - # customer will be None for "start" stamps, having no end time - if customer: - start = datetime.strptime(stamp['start'], self.datetime_format) - end = datetime.strptime(stamp['end'], self.datetime_format) - if filter_from and start < filter_from: - # if there is a filter setting a starting date for the - # report and the current stamp is from an earlier date, do - # not add it to the totals - continue - if filter_to and start > filter_to: - # similar for the end date - continue - if filter_descr and filter_descr not in stamp['action']: - continue - if customer not in totals: - totals[customer] = 0 - totals[customer] += self.worktime(stamp['start'], stamp['end']) - return totals - - def details(self, filter_customer=None, filter_from=None, filter_to=None, - filter_descr=None): - details = OrderedDict() - totals = OrderedDict() - total_customer = OrderedDict() - for stamp in self.stamps: - customer = stamp['customer'] - if customer: - if filter_customer and customer != filter_customer: - # we are getting the details for only one customer, if this - # stamp is not for that customer, simply move on and ignore - # it - continue - start = datetime.strptime(stamp['start'], self.datetime_format) - start_day = start.strftime('%Y-%m-%d') - end = datetime.strptime(stamp['end'], self.datetime_format) - if filter_from and start < filter_from: - # if there is a filter setting a starting date for the - # report and the current stamp is from an earlier date, do - # not add it to the totals - continue - if filter_to and start > filter_to: - # similar for the end date - continue - if filter_descr and filter_descr not in stamp['action']: - continue - # avoid "start" stamps + if stamp['customer'] == customer: + start_day = stamp['start'].split(' ')[0] if start_day not in details: details[start_day] = [] @@ -169,280 +82,12 @@ totals[start_day] = 0 worktime = self.worktime(stamp['start'], stamp['end']) - str_worktime = str(timedelta(seconds=worktime)) - if not self.wants_seconds or self.wants_seconds == 'false': - # remove the seconds part from the string representation - str_worktime = ':'.join(str_worktime.split(':')[:-1]) details[start_day].append( - '%(worktime)s %(customer)s %(action)s' % { - 'worktime': str_worktime, - 'customer': customer, + ' -> %(worktime)s %(customer)s %(action)s' % { + 'worktime': str(timedelta(seconds=worktime)), + 'customer': stamp['customer'], 'action': stamp['action'] }) totals[start_day] += worktime - if start_day not in total_customer: - total_customer[start_day] = {} - if customer not in total_customer[start_day]: - total_customer[start_day][customer] = 0 - total_customer[start_day][customer] += worktime for day in totals: totals[day] = str(timedelta(seconds=totals[day])) - if not self.wants_seconds or self.wants_seconds == 'false': - # remove the seconds part from the string representation - totals[day] = ':'.join(totals[day].split(':')[:-1]) - return details, totals, total_customer - - def timeline(self, customer=None, stamp_filter=None, filter_descr=None): - filter_from, filter_to = self.date_filter.validate(stamp_filter) - for stamp in self.stamps: - start = datetime.strptime(stamp['start'], self.datetime_format) - start_day = start.strftime('%Y-%m-%d') - if filter_from and start < filter_from: - # if there is a filter setting a starting date for the - # report and the current stamp is from an earlier date, do - # not add it to the totals - continue - if filter_to and start > filter_to: - # similar for the end date - continue - if filter_descr and stamp['action']: - if filter_descr not in stamp['action']: - continue - if not stamp['customer']: - if customer is None: - print(stamp['start'] + ' start') - else: - if customer and customer != stamp['customer']: - continue - if customer: - print(stamp['start'] + ' start') - print(' '.join([stamp['end'], - stamp['customer'], - stamp['action']])) - - def graph_stamps(self, customer=None, stamp_filter=None, filter_descr=None): - """ - Generate charts with information from the stamps - """ - filter_from, filter_to = self.date_filter.validate(stamp_filter) - chart = pygal.Bar(title='Work hours per day', - range=(0, self.hours_day), - x_title='Days', - y_title='Work hours', - x_label_rotation=45) - - details, totals, totals_customers = self.details(customer, - filter_from, - filter_to, - filter_descr) - days = [] - values = {} - for c in self.customers: - values[c] = [] - - found = [] - - for day in details: - for c in values: - seconds = totals_customers[day].get(c, 0) - if seconds and c not in found: - found.append(c) - human = timedelta(seconds=seconds).__str__() - values[c].append({'value': seconds/60.00/60.00, - 'label': day + ': ' + human}) - days.append(day) - chart.x_labels = map(str, days) - - if customer: - chart.add(customer, values[customer]) - else: - for c in found: - chart.add(c, values[c]) - - chart_name = 'chart-%s.svg' % datetime.today().strftime( - '%Y-%m-%d_%H%M%S') - chart_symlink = 'chart-latest.svg' - chart_path = os.path.join(self.charts_dir, chart_name) - chart_symlink_path = os.path.join(self.charts_dir, chart_symlink) - - chart.render_to_file(chart_path) - print('Rendered chart: ' + chart_path) - if os.path.islink(chart_symlink_path): - remove(chart_symlink_path) - symlink(chart_name, chart_symlink_path) - print('Updated latest chart: ' + chart_symlink_path) - - def show_stamps(self, customer=None, stamp_filter=None, verbose=False, - sum=False, filter_descr=None): - filter_from, filter_to = self.date_filter.validate(stamp_filter) - - # If the user asks for verbose information, show it before the - # totals (mimicing what the original stamp tool does) - if verbose: - details, totals, total_customer = self.details(customer, - filter_from, - filter_to, - filter_descr) - for day in details: - print('------ %(day)s ------' % {'day': day}) - for line in details[day]: - print(line) - customer_day_totals = [] - for tc in total_customer[day]: - tc_total = str(timedelta(seconds=total_customer[day][tc])) - if not self.wants_seconds or self.wants_seconds == 'false': - # remove the seconds part from the string representation - tc_total = ':'.join(tc_total.split(':')[:-1]) - # ensure hours show double digits - tc_total = tc_total.zfill(5) - customer_day_totals.append(tc+': '+tc_total) - print(', '.join(customer_day_totals)) - if len(customer_day_totals) > 1: - # if there are multiple customers in the report, show the - # daily totals - print('daily total: %(total)s' % {'total': totals[day]}) - print('-'*79) - - # now calculate the totals and show them - totals = self.totals(filter_from, filter_to, filter_descr) - if customer: - seconds=totals.get(customer, 0) - total = timedelta(seconds=totals.get(customer, 0)) - h, m, s = timedelta_to_hms(total) - total = ':'.join( - [str(h).zfill(2), str(m).zfill(2), str(s).zfill(2)]) - if not self.wants_seconds or self.wants_seconds == 'false': - # remove the seconds part from the string representation - total = ':'.join(str(total).split(':')[:-1]) - print(' %(customer)s: %(total)s' % {'customer': customer, - 'total': total}) - else: - for c in totals: - seconds=totals[c] - total = timedelta(seconds=totals[c]) - h, m, s = timedelta_to_hms(total) - total = ':'.join( - [str(h).zfill(2), str(m).zfill(2), str(s).zfill(2)]) - if not self.wants_seconds or self.wants_seconds == 'false': - # remove the seconds part from the string representation - total = ':'.join(str(total).split(':')[:-1]) - print(' %(customer)s: %(total)s' % {'customer': c, - 'total': total}) - - if sum: - sum_tot = '' - if totals: - print('------ Totals ------' % {'day': day}) - for day, tot in totals.items(): - print(' %(day)s: %(total)s' % {'day': day, 'total': tot}) - sum_tot = "%(total)s %(new)s" % { - 'total': sum_tot, - 'new': total - } - totalSecs, sec = divmod(seconds, 60) - hr, min = divmod(totalSecs, 60) - totalDays, remaining = divmod(seconds, - (self.hours_day * 60 * 60)) - remainingMin, remainingSec = divmod(remaining, (60)) - remainingHr, remainingMin = divmod(remainingMin, (60)) - print('----- %d:%02d:%02d -----' % (hr, min, sec)) - print('--- %d days, remaining: %d:%02d (%d hours/day) ---' % ( - totalDays, remainingHr, remainingMin, self.hours_day - )) - - def remove_stamps(self, n=1): - """ - Remove up to n stamps back, asking for confirmation before delete - """ - for i in range(n): - stamp = self.last_stamp() - if not stamp['customer']: - print(stamp['start'] + ' start') - else: - print(' '.join([stamp['end'], - stamp['customer'], - stamp['action']])) - confirm = '' - while confirm.lower() not in ['y', 'n']: - confirm = input('delete stamp? (y/n) ') - confirm = confirm.lower() - if confirm == 'y': - self.stamps.pop() - else: - # if the user says no to the removal of an stamp, we cannot - # keep deleting stamps after that one, as that could leave the - # stamps in an inconsistent state. - print('Aborting removal of stamps') - break - self.save_stamps() - - def import_stamps(self, filename): - """ - Import the stamps from the given file into the main stamps list, - merging them into the list (removing duplicated entries) - """ - if not os.path.exists(filename): - print('[error] ' + filename + 'does not exist') - return - if os.path.isdir(filename): - print('[error] ' + filename + 'is a directory') - return - stamps = self.__json_load(filename) - if not stamps: - print('[warning] no stamps can be imported from ' + filename) - return - self.stamps.extend(stamps) - self.remove_duplicates() - self.sort_stamps() - self.save_stamps() - print('[warning] ' + str(len(stamps)) + ' stamps merged') - print('[warning] remember to review the resulting stamps file') - - def push_stamps(self, customer=None, stamp_filter=None, filter_descr=None): - filter_from, filter_to = self.date_filter.validate(stamp_filter) - - stamps = [] - for stamp in self.stamps: - if stamp['customer']: - if customer and customer != stamp['customer']: - continue - start = datetime.strptime(stamp['start'], self.datetime_format) - start_day = start.strftime('%Y-%m-%d') - end = datetime.strptime(stamp['end'], self.datetime_format) - if filter_from and start < filter_from: - # if there is a filter setting a starting date for the - # report and the current stamp is from an earlier date, do - # not add it to the totals - continue - if filter_to and start > filter_to: - # similar for the end date - continue - if filter_descr and filter_descr not in stamp['action']: - continue - stamps.append(stamp) - - stamps = json.dumps(stamps, indent=4) - http_client = HTTPClient(self.collector['base_url']) - response = http_client.post(self.collector['login_path'], - {'username': self.collector['user'], - 'password': self.collector['password']}) - # response is a json-encoded list of end-points from the collector api - try: - api = json.loads(response) - except ValueError: - print('[error] No valid api end points can be retrieved') - return - - response = http_client.post(api['push'], {'stamps': stamps}) - - # response is a json-encoded dict, containing lists of added, updated - # and deleted stamps (on the other side) - try: - results = json.loads(response) - except ValueError: - print('[error] stamps pushed, can not retrieve results information') - return - - # display information - for k in results.keys(): - print('%(stamps)d stamps %(action)s' % {'stamps': len(results[k]), - 'action': k}) + return details, totals