{ "info": { "author": "discretelogics", "author_email": "pythonapi@discretelogics.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved", "License :: OSI Approved :: GNU General Public License (GPL)", "Operating System :: MacOS", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Operating System :: Unix", "Programming Language :: Python", "Topic :: Scientific/Engineering", "Topic :: Software Development" ], "description": "Time Series Peristence\n======================\nThis Python package provides Time Series storage in flat files according to the **TeaFile** file format.\n\n\nIn Use\n======\n\n>>> tf = TeaFile.create(\"acme.tea\", \"Time Price Volume\", \"qdq\", \"ACME at NYSE\", {\"decimals\": 2, \"url\": \"www.acme.com\" })\n>>> tf.write(DateTime(2011, 3, 4, 9, 0), 45.11, 4500)\n>>> tf.write(DateTime(2011, 3, 4, 10, 0), 46.33, 1100)\n>>> tf.close()\n\n>>> tf = TeaFile.openread(\"acme.tea\")\n>>> tf.read()\nTPV(Time=2011-03-04 09:00:00:000, Price=45.11, Volume=4500)\n>>> tf.read()\nTPV(Time=2011-03-04 10:00:00:000, Price=46.33, Volume=1100)\n>>> tf.read()\n>>> tf.close()\n\n\nExchange Time Series between Apps / OS\n======================================\nYou can create, read and write TeaFiles with\n\n- R,\n- C++,\n- C# or\n- other applications\n\non\n\n- Linux, Unix,\n- Mac OS\n- Windows\n\n\nPython API Examples\n===================\n- programs http://discretelogics.com/PythonAPI/examples.html\n- interactive http://discretelogics.com/PythonAPI/interactive.html\n- examples.py (available in the package source)\n\n\nTeaFiles\n========\nTeaFiles are a very **simple**, yet highly **efficient**, way to store time series data \nproviding data exchange between programs written in C++, C# or applications like R, Octave, \nMatlab, running on Linux, Unix, Mac OS X or Windows.\n\n- **Binary** data composed from elementary data types **signed and unsigned integers, double and float** in IEEE 754 format is prefixed by a **header** holding a description of the item structure and the content.\n- Data can be directly accessed via **memory mapping**. \n- TeaFiles are **self describing**: Containing a description of the item structure they relieve opaqueness of straight binary files. Knowing that a file is a TeaFile is enough to access its data.\n\nlink to spec http://tbd\n\n\nScope of the Python API\n=======================\nThe Python API makes TeaFiles accessible everywhere. It just needs a python installation on any OS to inspect the description and data \nof a TeaFile:\n\n\n>>> # Show the decimals and displayname for all files in a folder:\n...\n>>> def showdecimals():\n ... for filename in os.listdir('.'):\n ... with TeaFile.openread(filename) as tf:\n ... nvs = tf.description.namevalues\n ... print('{} {} {}'.format(filename, nvs.get('Decimals'), nvs.get('DisplayName')))\n ... \n >>> showdecimals()\n AA.day.tea 2 Alcoa, Inc.\n AA.tick.tea 2 Alcoa, Inc.\n AXP.day.tea 2 American Express Co.\n ...\n\nData download from web services is also a good fit. See the examples.py file in the package source for a Yahoo finance download function in about 30 lines.\n\n\nLimitations\n===========\nWhen it comes to high performance processing of very large time series files, this API is currently not as fast as the C++ and C# APIs (Numbers coming soon on http://tbd). There are numerous ways to improve this if necessary, but no current plans at discretelogics to do so. Using the other languages/APIs is recommended. If you wish the Python API to be faster or want to work on that contact us.\n\n\nInstallation\n============\n\n**$ pip install teafiles**\n\npackage source with examples.py at http://bitbucket.org/discretelogics/teafiles.py\n\nTests\n=====\nRun the unit tests from the package root by\n\n$ python -m pytest .\\test\n\n\nPython 2.7 / 3.2\n================\nPackage tested under CPython 2.7.\nPython 3.2 planned\n\n\nAuthor\n======\nThis API brought to you by discretelogics, company specialicing in time series analysis and event processing.\nhttp://tbd\n\n\nVersion 0.7\n===========\nThe current version is reasonably tested by doctests and some pytests. Better test coverage with unit tests (currently pytest is used) \nis desirable.\n\ntbd towards version 1.0\n - enhance pytest coverage\n - consider api feedack\n - cleaner test runs, cleanup test files\n\noptional\n - enhance performance after measuring it in python 3 (maybe struct module plays a minor role there)\n\n\nLicense\n=======\nThis package is released under the GNU GENERAL PUBLIC LICENSE, see License.txt.\n\n\nFeedback\n========\nWelcome at: pythonapi@discretelogics.com", "description_content_type": null, "docs_url": null, "download_url": "http://pypi.python.org/packages/source/t/teafiles", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://discretelogics.com", "keywords": "timeseries time series analysis event processing teatime simulation finance", "license": "Creative Commons Attribution-Noncommercial-Share Alike license", "maintainer": null, "maintainer_email": null, "name": "teafiles", "package_url": "https://pypi.org/project/teafiles/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/teafiles/", "project_urls": { "Download": "http://pypi.python.org/packages/source/t/teafiles", "Homepage": "http://discretelogics.com" }, "release_url": "https://pypi.org/project/teafiles/0.7.4/", "requires_dist": null, "requires_python": null, "summary": "Time Series storage in flat files.", "version": "0.7.4" }, "last_serial": 800399, "releases": { "0.7.2.1 dev": [ { "comment_text": "", "digests": { "md5": "4eefd9c3da82d5ae5bebe06cda96f096", "sha256": "80ddeffc87ce39f032dd3fd051821feaa91e33c30772aa0bd83409b79ccd5d52" }, "downloads": -1, "filename": "teafiles-0.7.2.1 dev.zip", "has_sig": false, "md5_digest": "4eefd9c3da82d5ae5bebe06cda96f096", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45000, "upload_time": "2012-01-31T14:51:18", "url": "https://files.pythonhosted.org/packages/e7/d9/2fa65fea38987dee7b0ce391e88fd57f981d5612c5bb527152c0549cf8b8/teafiles-0.7.2.1%20dev.zip" } ], "0.7.3": [ { "comment_text": "", "digests": { "md5": "80c84f5ce784d21212e9da0162edfedf", "sha256": "044e0326bd32cad7f2a165c7b697d1098f263c39781c0fa3c24a2924e3f6ef73" }, "downloads": -1, "filename": "teafiles-0.7.3.zip", "has_sig": false, "md5_digest": "80c84f5ce784d21212e9da0162edfedf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45033, "upload_time": "2012-02-01T18:08:25", "url": "https://files.pythonhosted.org/packages/b6/8d/15234863211ee5471d4854b1b09f4307cf41a401f5dd63c85adafef0feba/teafiles-0.7.3.zip" } ], "0.7.4": [ { "comment_text": "", "digests": { "md5": "c6a4cca7fff1e5a5d01c2c59b3339b04", "sha256": "99d103b1ff58120bd7df5a9280f3cec69902603ed581d3d04e3f0e34ee640215" }, "downloads": -1, "filename": "teafiles-0.7.4.zip", "has_sig": false, "md5_digest": "c6a4cca7fff1e5a5d01c2c59b3339b04", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44925, "upload_time": "2012-02-01T18:16:07", "url": "https://files.pythonhosted.org/packages/c1/3e/0ff9a84afce6a9b30e625e30914899026a17408e746d4052ba49dba96eba/teafiles-0.7.4.zip" } ], "0.71 dev": [ { "comment_text": "", "digests": { "md5": "6ae4134a2717a4dd0b7957de66723fcd", "sha256": "1e7f8cc61f4386be38393b3852b6bffd11dc2a958919f7218a1e3c4e493768b1" }, "downloads": -1, "filename": "teafiles-0.71 dev.zip", "has_sig": false, "md5_digest": "6ae4134a2717a4dd0b7957de66723fcd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44931, "upload_time": "2012-01-31T14:47:55", "url": "https://files.pythonhosted.org/packages/24/cd/65e64495805eddf016de7787cf9d9d450027582c40cf614ebc41aba6bb00/teafiles-0.71%20dev.zip" } ], "0.7dev": [ { "comment_text": "", "digests": { "md5": "31cb2bf5ddba602c885bbc687978346a", "sha256": "79fbc7aa1a3528d868a46af4daaf167b14c2e8d32c30f2a5e06b7dc6f48d4397" }, "downloads": -1, "filename": "teafiles-0.7dev.zip", "has_sig": false, "md5_digest": "31cb2bf5ddba602c885bbc687978346a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44831, "upload_time": "2012-01-31T14:28:17", "url": "https://files.pythonhosted.org/packages/85/d4/0232b7d90114d91ebc49084a6e833e83dfbe54851a5fe78a8becc6cc4341/teafiles-0.7dev.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c6a4cca7fff1e5a5d01c2c59b3339b04", "sha256": "99d103b1ff58120bd7df5a9280f3cec69902603ed581d3d04e3f0e34ee640215" }, "downloads": -1, "filename": "teafiles-0.7.4.zip", "has_sig": false, "md5_digest": "c6a4cca7fff1e5a5d01c2c59b3339b04", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44925, "upload_time": "2012-02-01T18:16:07", "url": "https://files.pythonhosted.org/packages/c1/3e/0ff9a84afce6a9b30e625e30914899026a17408e746d4052ba49dba96eba/teafiles-0.7.4.zip" } ] }