{ "info": { "author": "Janusz Skonieczny", "author_email": "js+pypi@bravelabs.pl", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "===========\nFakturownia\n===========\n\nPython client library for the Fakturownia API\n\n\n.. image:: https://img.shields.io/pypi/v/fakturownia.svg\n :target: https://pypi.python.org/pypi/fakturownia\n\n.. image:: https://img.shields.io/travis/wooyek/fakturownia-python.svg\n :target: https://travis-ci.org/wooyek/fakturownia-python\n\n.. image:: https://readthedocs.org/projects/fakturownia/badge/?version=latest\n :target: https://fakturownia.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n.. image:: https://coveralls.io/repos/github/wooyek/fakturownia-python/badge.svg?branch=develop\n :target: https://coveralls.io/github/wooyek/fakturownia-python?branch=develop\n :alt: Coveralls.io coverage\n\n.. image:: https://codecov.io/gh/wooyek/fakturownia-python/branch/develop/graph/badge.svg\n :target: https://codecov.io/gh/wooyek/fakturownia-python\n :alt: CodeCov coverage\n\n.. image:: https://api.codeclimate.com/v1/badges/0e7992f6259bc7fd1a1a/maintainability\n :target: https://codeclimate.com/github/wooyek/fakturownia-python/maintainability\n :alt: Maintainability\n\n.. image:: https://img.shields.io/github/license/wooyek/fakturownia-python.svg\n :target: https://github.com/wooyek/fakturownia-python/blob/develop/LICENSE\n :alt: License\n\n.. image:: https://img.shields.io/twitter/url/https/github.com/wooyek/fakturownia-python.svg?style=social\n :target: https://twitter.com/intent/tweet?text=Wow:&url=https://github.com/wooyek/fakturownia-python\n :alt: Tweet about this project\n\n.. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg\n :target: https://saythanks.io/to/wooyek\n\nIf you don't know it yet be sure to check it out:\n\n.. image:: //app.fakturownia.pl/polecam-fakturownie-niebieski.png\n :target: http://fakturownia.pl\n :alt: Polecam Fakturownia.pl - prosty program do fakturowania online\n\n\n.. contents:: Table of Contents\n\nFeatures\n--------\n\n* \u2611 Invoice CRUD plus `send_by_email` and 'mark_paid`\n* \u2611 EU member states VAT rate helpers for B2C transactions\n* \u2611 ApiClient CRUD\n* \u2610 Payments CRUD\n* \u2610 Products CRUD\n* \u2610 Warehouse documents CRUD\n* \u2610 Accounts management\n\nPlease refer to the `fakturownia APIs`_ for full API features\n\nQuickstart\n----------\n\nInstall Fakturownia\n\n pip install fakturownia\n python\n\nPlay with `fakturownia APIs`_ in python interpreter::\n\n >>> import os\n >>> os.environ.get('FAKTUROWNIA_API_TOKEN', 'Missing key')\n '...'\n >>> from fakturownia import get_api_client\n >>> api = get_api_client()\n >>> invoice = api.invoices.create(\n ... seller_name='Kabaret Starszych Pan\u00f3w',\n ... buyer_name='Odra\u017caj\u0105cy drab',\n ... positions=[{\n ... 'name': 'Smolna szczapa',\n ... 'quantity': 5,\n ... 'total_price_gross': 7.33,\n ... }],\n ... )\n >>> invoice.view_url\n '...'\n\nThis instance is only partially updated as create returns only subset of\ndata properties, to get all we need to update our instance.\n\nIf you have payments enabled you can call get to fetch all data and check payment_url::\n\n >>> invoice.get()\n \n >>> invoice.payment_url\n '...'\n\nWe can mark this invoice as paid::\n\n >>> invoice.mark_paid()\n \n\nYou can chain your calls::\n\n >>> invoice.put(buyer_email='kominek@niepodam.pl').send_by_email()\n \n\nYou can play and test your scenarios wih factories::\n\n pip install fakturownia[factories]\n python\n\nNow you can do this::\n\n >>> from fakturownia.factories import InvoiceFactory\n >>> InvoiceFactory(api_client='', kind='proforma').post().get().payment_url # doctest: +SKIP\n '...'\n\nAlso checkout VAT tax normalization based on\n`EU country specific VAT rates `_::\n\n >>> InvoiceFactory(\n ... api_client=api,\n ... seller_country='PL',\n ... buyer_country='DE',\n ... buyer_tax_no=None,\n ... ).normalize_vat().post().view_url\n '...'\n\nNeat! :)\n\n\nRunning Tests\n-------------\n\nDoes the code actually work?\n\n.. code-block:: sh\n\n pipenv install --dev\n pipenv shell\n tox\n\n\nWe recommend using pipenv_ but a legacy approach to creating virtualenv and installing requirements should also work.\nPlease install `requirements/base.txt` and `requirements/development.txt` to setup virtual env for testing and development.\n\nHelp wanted\n-----------\n\nThis library is not yet complete. It does what was needed by up to date contributors, but more can be done.\nYou can implement new api endpoints and write test for them, it's actually straightforward and new classes will be simple,\nbut tests need some effort. We are lazy test writers and because we don't want to compromise coverage so we\npostponed new apis until someone would want to write test.\n\nIf want to help please refer to the\n`contributing section `_ in the docs for more info.\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `wooyek/cookiecutter-pylib`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`wooyek/cookiecutter-pylib`: https://github.com/wooyek/cookiecutter-pylib\n.. _`pipenv`: https://docs.pipenv.org/install#fancy-installation-of-pipenv\n.. _`fakturownia APIs`: https://github.com/fakturownia/api\n\n\n\n\nHistory\n-------\n\n0.1.0 (2018-01-03)\n++++++++++++++++++\n\n* First release on PyPI.\n\n0.1.2 (2018-01-10)\n++++++++++++++++++\n\n* endpoints indexing\n* Robust testing with mocked and real interchangeable backeds .\n\n0.2.1 (2018-01-12)\n++++++++++++++++++\n\n* EU member states VAT rate helpers for B2C transactions\n* FAKTUROWNIA_TIMEOUT setting for request timeout\n\n0.2.2 (2018-01-18)\n++++++++++++++++++\n\n* Payload data cleanup from readonly fields so get().put() is possible\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/wooyek/fakturownia-python", "keywords": "fakturownia-python", "license": "MIT license", "maintainer": "", "maintainer_email": "", "name": "fakturownia", "package_url": "https://pypi.org/project/fakturownia/", "platform": "", "project_url": "https://pypi.org/project/fakturownia/", "project_urls": { "Homepage": "https://github.com/wooyek/fakturownia-python" }, "release_url": "https://pypi.org/project/fakturownia/0.2.2/", "requires_dist": null, "requires_python": "", "summary": "Python client library for the Fakturownia API", "version": "0.2.2" }, "last_serial": 3500906, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "1df7f24676afb380ea900ec04e0617f7", "sha256": "537bb6539d0caadad7ace734e2222819f462b6ac4128023619e0da282b4a5926" }, "downloads": -1, "filename": "fakturownia-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "1df7f24676afb380ea900ec04e0617f7", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 9410, "upload_time": "2018-01-05T09:44:51", "url": "https://files.pythonhosted.org/packages/71/d3/85f89ec938f951ee2ddcdbf83ae975a62fa3c3e18c2713acfe72f4d3eb0a/fakturownia-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c0147981a8807b0a202d911ed0b0a4f7", "sha256": "acc1b35e9b5ab1573765cba54acfe09af08775aa4dcbf6399e23a8bb3c5df124" }, "downloads": -1, "filename": "fakturownia-0.1.1.tar.gz", "has_sig": false, "md5_digest": "c0147981a8807b0a202d911ed0b0a4f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41120, "upload_time": "2018-01-05T09:44:48", "url": "https://files.pythonhosted.org/packages/ae/1e/b3be353c89d8ecaac1cedfc60bc4a3a41b67e48853642675652a6aee771b/fakturownia-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "402327c57ec548506204f73800fa69ff", "sha256": "18809087ddd2fddd065c954c4e4064688d23a274ebdd664cc8a04d5ecf73fca8" }, "downloads": -1, "filename": "fakturownia-0.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "402327c57ec548506204f73800fa69ff", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 13054, "upload_time": "2018-01-10T14:16:21", "url": "https://files.pythonhosted.org/packages/3b/bd/3ab8ecf26687e731bbd17697948312e36ea5249f9bc334424c3d11a23df1/fakturownia-0.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2f744abe6085313c1033440f73f5c425", "sha256": "3f689952541546cb94996faec750076efb94a18868344faabd2eaac5f2535a13" }, "downloads": -1, "filename": "fakturownia-0.1.2.tar.gz", "has_sig": false, "md5_digest": "2f744abe6085313c1033440f73f5c425", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59602, "upload_time": "2018-01-10T14:16:18", "url": "https://files.pythonhosted.org/packages/c4/77/2210f886e61de101c8910f8278000ac82693c24f16f50a178e632470711c/fakturownia-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "a2e01921b69de34c04c7da7161baed80", "sha256": "59a7d2c657156a0e7cc6ad78c4e491d5f02ce185d8dcdcb793682025e73fc7a8" }, "downloads": -1, "filename": "fakturownia-0.1.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "a2e01921b69de34c04c7da7161baed80", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 13148, "upload_time": "2018-01-10T19:32:09", "url": "https://files.pythonhosted.org/packages/34/76/12181402c2d1e5ab1dd19efcac0f760a75b1e73b54bf99926a2cbcc55fbc/fakturownia-0.1.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "75e750a225b68e269451c47afa228c07", "sha256": "9d280e4987dab1fa94ae013cfe3fbacee71cb9cdb8fac30df8703bad0a39eb3f" }, "downloads": -1, "filename": "fakturownia-0.1.3.tar.gz", "has_sig": false, "md5_digest": "75e750a225b68e269451c47afa228c07", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59858, "upload_time": "2018-01-10T19:32:06", "url": "https://files.pythonhosted.org/packages/6e/55/61539b6e67a607b3458ef397de3180fe6e50187aac4ec279d5b5c5827582/fakturownia-0.1.3.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "e9424a837f078d7cb4b1a41e8c488535", "sha256": "0267f55979d6def8523751855af51e3389abd411ad63e0b4690069731401d6e6" }, "downloads": -1, "filename": "fakturownia-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e9424a837f078d7cb4b1a41e8c488535", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 13148, "upload_time": "2018-01-10T19:50:57", "url": "https://files.pythonhosted.org/packages/fb/df/ec9dba537fb48c6e9e37682c02a3a9bc0936c1269a2afd8861a7d1519beb/fakturownia-0.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7c196fbdcfcdd3373939881ef782f8e5", "sha256": "5af3d953cb0994c679abe5134cc77f9fcaf6e12dc5ff944f475008dc804119f4" }, "downloads": -1, "filename": "fakturownia-0.2.0.tar.gz", "has_sig": false, "md5_digest": "7c196fbdcfcdd3373939881ef782f8e5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59887, "upload_time": "2018-01-10T19:50:55", "url": "https://files.pythonhosted.org/packages/14/d0/e153cd1ae620f960c49d0d27e765e3b3ede827cb36e2a1c0cc8c1ee8e619/fakturownia-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "5094b165899d49500335aa49d4f8e5e9", "sha256": "7cfbeb86abd81cd452de8e1638669012c5fd82fd4e630524515c8a3a9053aebb" }, "downloads": -1, "filename": "fakturownia-0.2.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5094b165899d49500335aa49d4f8e5e9", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 15794, "upload_time": "2018-01-15T16:58:31", "url": "https://files.pythonhosted.org/packages/82/21/e348d42244c98b0db86fe8f0df174d803afcbb7283767358a5b9248ffd5f/fakturownia-0.2.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "51ec99dfbe6111ba97d81d20abf55dd9", "sha256": "e50bb2c6aa1670050dc0522233e5a0cb4077dfe5f92f184a2e9028444197fcfc" }, "downloads": -1, "filename": "fakturownia-0.2.1.tar.gz", "has_sig": false, "md5_digest": "51ec99dfbe6111ba97d81d20abf55dd9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44269, "upload_time": "2018-01-15T16:58:23", "url": "https://files.pythonhosted.org/packages/a5/7d/7ca76bcf55a591ec87727c46a00cf6fbe9688b4b6e09b25d5bac48b1b9ed/fakturownia-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "bdfdfd47c663b57a4a0817c92555aecf", "sha256": "7e027f03e2be163dca7954e737ddc48c03cb3968243e043e131c92872b6568d3" }, "downloads": -1, "filename": "fakturownia-0.2.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "bdfdfd47c663b57a4a0817c92555aecf", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 16048, "upload_time": "2018-01-18T13:59:27", "url": "https://files.pythonhosted.org/packages/b6/35/2ece24f5a9d2c053ec08e5499c2f73960891fd695aa1b8b3f52c96e93ca5/fakturownia-0.2.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "09fa92085ac712fd64513192461b74a6", "sha256": "8c6c81c79215b26ff909daf5ed756dbc6045ffde176c1dd2354bffc623ed04d8" }, "downloads": -1, "filename": "fakturownia-0.2.2.tar.gz", "has_sig": false, "md5_digest": "09fa92085ac712fd64513192461b74a6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 65027, "upload_time": "2018-01-18T13:59:24", "url": "https://files.pythonhosted.org/packages/87/58/2973f63edd40ea56704928c9533bcf4d6c142ae898f4a833c4e0c1532ecd/fakturownia-0.2.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "bdfdfd47c663b57a4a0817c92555aecf", "sha256": "7e027f03e2be163dca7954e737ddc48c03cb3968243e043e131c92872b6568d3" }, "downloads": -1, "filename": "fakturownia-0.2.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "bdfdfd47c663b57a4a0817c92555aecf", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 16048, "upload_time": "2018-01-18T13:59:27", "url": "https://files.pythonhosted.org/packages/b6/35/2ece24f5a9d2c053ec08e5499c2f73960891fd695aa1b8b3f52c96e93ca5/fakturownia-0.2.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "09fa92085ac712fd64513192461b74a6", "sha256": "8c6c81c79215b26ff909daf5ed756dbc6045ffde176c1dd2354bffc623ed04d8" }, "downloads": -1, "filename": "fakturownia-0.2.2.tar.gz", "has_sig": false, "md5_digest": "09fa92085ac712fd64513192461b74a6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 65027, "upload_time": "2018-01-18T13:59:24", "url": "https://files.pythonhosted.org/packages/87/58/2973f63edd40ea56704928c9533bcf4d6c142ae898f4a833c4e0c1532ecd/fakturownia-0.2.2.tar.gz" } ] }