{ "info": { "author": "NE Automation", "author_email": "code@neautomation.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy" ], "description": "# mailprep\n\n[![builds.sr.ht status](https://builds.sr.ht/~lucidone/mailprep.svg)](https://builds.sr.ht/~lucidone/mailprep?)\n\n-----\n\n**Table of Contents**\n\n* [Overview](#overview)\n* [Usage](#usage)\n* [Installation](#installation)\n* [Testing](#testing)\n* [Templates](#templates)\n* [License](#license)\n\n## Overview\n\n[mailprep](https://git.sr.ht/~lucidone/mailprep) converts [vCard](https://en.wikipedia.org/wiki/VCard) data into physical labels with a *Dymo LabelWriter 4XL*.\n\n## Usage\n\n```console\n$ mailprep --help\nUsage: mailprep [OPTIONS] VCF_FILEPATH [TEMPLATE_FILEPATH]\n\nOptions:\n --printer TEXT Printer Name\n --count INTEGER number of labels to print\n --simulate Generate output PDF without printing\n --help Show this message and exit.\n```\n\nThe default template is designed for 2.25\" \u00d7 1.25\" Uline S-12996 labels.\n\n## Installation\n\nmailprep is distributed on [PyPI](https://pypi.org) as a universal\nwheel and is available on Linux/macOS and Windows and supports\nPython 3.5+ and PyPy.\n\n```console\n$ pip install mailprep\n```\n\n### Debian\n\nThe DYMO printer driver can be installed with\n\n```console\n$ apt-get install printer-driver-dymo\n```\n\n\n## Testing\n\n### System Dependencies\n\n#### Debian/Stretch\n\nTesting requires `pdftotext` and `tox`\n\n```console\n$ apt-get install poppler-utils tox\n```\n\n### Automatic Tests\nAutomatic tests can be run via any of the following methods depending on your workflow\n\n```console\n$ python setup.py test\n```\n\n```console\n$ hatch test\n```\n\n```console\n$ tox\n```\n\n### HitL Tests\nHuman/Hardware in the Loop tests can be run manually if `xdg-open` can find a pdf reader and a printer is connected.\n\n```console\n$ hatch test --test-args \"--hitl\"\n```\n\n```console\n$ tox -- --hitl\n```\n\n## Templates\nTemplates are stored as [SVG](https://en.wikipedia.org/wiki/Scalable_Vector_Graphics) and are evaluated using the Moustache template syntax. Currently the template processing is US-centric, but pull requests and test data is appreciated.\n\n### Formatted name\n`{{ fn }}` in the template is replaced with the [formatted name](https://tools.ietf.org/html/rfc2426#section-3.1.1) from the vCard.\n\n### Address\nCurrently `mailprep` generate labels from the vCard [ADR Type Definition](https://tools.ietf.org/html/rfc2426#section-3.2.1). In the future it may make more sense to use the [LABEL Type Definition](https://tools.ietf.org/html/rfc2426#section-3.2.2) but it is unclear which produced more consistent results.\n\n```\n{{ adr_street }}\n{{ adr_city }}, {{ adr_region }}\n{{ adr_code }}\n```\n\n## License\n\nmailprep is distributed under the terms of both\n\n- [MIT License](https://choosealicense.com/licenses/mit)\n- [Apache License, Version 2.0](https://choosealicense.com/licenses/apache-2.0)\n\nat your option.\n\n### Test data\nThe vCard test data is from [Wikipedia](https://en.wikipedia.org/wiki/Vcard#vCard_3.0)\nand is licensed as [Creative Commons Attribution-ShareAlike](https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License).\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://git.sr.ht/~lucidone/mailprep", "keywords": "", "license": "MIT/Apache-2.0", "maintainer": "NE Automation", "maintainer_email": "code@neautomation.com", "name": "mailprep", "package_url": "https://pypi.org/project/mailprep/", "platform": "", "project_url": "https://pypi.org/project/mailprep/", "project_urls": { "Homepage": "https://git.sr.ht/~lucidone/mailprep" }, "release_url": "https://pypi.org/project/mailprep/0.1.1/", "requires_dist": null, "requires_python": "", "summary": "mailprep converts vCard data into physical labels from SVG templates", "version": "0.1.1" }, "last_serial": 4843202, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "2ebe3cfdb80c3a3e8d6931f83a46429f", "sha256": "50b788dec18948d1413ed7eeb5f05143d460d71166e9339f9a2d1c8576aa6438" }, "downloads": -1, "filename": "mailprep-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "2ebe3cfdb80c3a3e8d6931f83a46429f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 12801, "upload_time": "2019-02-19T01:24:52", "url": "https://files.pythonhosted.org/packages/b5/0e/c4beb397bd58841bd430449fe060cbb9865573759a459ddb68f9f65ff920/mailprep-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "aaf1f8b59275b1bcd1cb613b21aabec3", "sha256": "c25bd3800f146219826b3f17f0f24b80ab1b18fbe83b82db461065e5870cca8e" }, "downloads": -1, "filename": "mailprep-0.1.0.tar.gz", "has_sig": false, "md5_digest": "aaf1f8b59275b1bcd1cb613b21aabec3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11472, "upload_time": "2019-02-19T01:24:55", "url": "https://files.pythonhosted.org/packages/48/d2/b908b0d2dfe12581ebb97b7131e99631f8405a1f7a4f12191a589df4b6ef/mailprep-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "21d41eaac3c91201626b70f5ee86bc02", "sha256": "ece3994743c96c0a53dbc7a301cf3ce3a2f3acead4226996cedeabdad437713b" }, "downloads": -1, "filename": "mailprep-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "21d41eaac3c91201626b70f5ee86bc02", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 12846, "upload_time": "2019-02-20T00:48:38", "url": "https://files.pythonhosted.org/packages/4d/0d/300873422a2e126a54fa3e274c691b0f20ad22e3bde7e87aa70dcf646f54/mailprep-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9833e6633530939593d245b1ca130d2c", "sha256": "81f3cf01d50bc12378ba81dc4b2c80089a60d3df0624f60ae371a723325c9717" }, "downloads": -1, "filename": "mailprep-0.1.1.tar.gz", "has_sig": false, "md5_digest": "9833e6633530939593d245b1ca130d2c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11573, "upload_time": "2019-02-20T00:48:39", "url": "https://files.pythonhosted.org/packages/5c/69/06a7876788da1167072b7fe0082e70f89e2a261bd3d2d78b8116a63538de/mailprep-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "21d41eaac3c91201626b70f5ee86bc02", "sha256": "ece3994743c96c0a53dbc7a301cf3ce3a2f3acead4226996cedeabdad437713b" }, "downloads": -1, "filename": "mailprep-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "21d41eaac3c91201626b70f5ee86bc02", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 12846, "upload_time": "2019-02-20T00:48:38", "url": "https://files.pythonhosted.org/packages/4d/0d/300873422a2e126a54fa3e274c691b0f20ad22e3bde7e87aa70dcf646f54/mailprep-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9833e6633530939593d245b1ca130d2c", "sha256": "81f3cf01d50bc12378ba81dc4b2c80089a60d3df0624f60ae371a723325c9717" }, "downloads": -1, "filename": "mailprep-0.1.1.tar.gz", "has_sig": false, "md5_digest": "9833e6633530939593d245b1ca130d2c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11573, "upload_time": "2019-02-20T00:48:39", "url": "https://files.pythonhosted.org/packages/5c/69/06a7876788da1167072b7fe0082e70f89e2a261bd3d2d78b8116a63538de/mailprep-0.1.1.tar.gz" } ] }