{ "info": { "author": "Mathias Stelzer", "author_email": "knoppo@rolln.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "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", "Topic :: System :: Archiving", "Topic :: System :: Archiving :: Compression" ], "description": "######\nxtract\n######\n\n|pipeline|_ |coverage|_\n\nCode: https://rolln.de/knoppo/xtract\n\nDocumentation: https://docs.rolln.de/knoppo/xtract/master\n\nCoverage: https://coverage.rolln.de/knoppo/xtract/master\n\n\nPython library providing an API to unpack/decompress and pack/compress directories and files.\nIt's a wrapper around the supported archive and compression formats.\n\n**Supported Archives:**\n\n Archives are *always* unpacked to a new directory!\n\n* **rar**\n\n * application/rar\n * application/x-rar\n\n* **zip**\n\n * application/zip\n * application/x-zip\n\n* **tar**\n\n *no compression (See usage examples below for an example of adding compression)*\n\n * application/tar\n * application/x-tar\n\n\n**Supported Compressions:**\n\n* **gz**\n\n * application/gzip\n * application/x-gzip\n\n* **xz**\n\n * application/xz\n * application/x-xz\n\n* **bz2**\n\n * application/bzip\n * application/x-bzip\n\n\nInstallation\n============\n\n.. code-block:: bash\n\n pip install xtract\n\n\nSee the `quickstart documentation `_\nfor more detailed installation instructions.\n\n\nUsage Examples\n==============\n\nThe convenience function ``xtract`` can be used to unpack/decompress anything:\n\n.. code-block:: python\n\n >>> from xtract import xtract\n >>> xtract('my-directory.tar.gz')\n '/home//my-directory.tar'\n\n\nUse the ``all`` switch to loop until ``FileTypeNotSupported`` is raised:\n\n.. code-block:: python\n\n >>> xtract('my-directory.tar.gz', all=True)\n '/home//my-directory'\n\n\nCompress a file:\n\n.. code-block:: python\n\n >>> from xtract import bz2\n >>> bz2('my-file.txt', delete_source=True)\n '/home//my-file.txt.bz2'\n\n\nEvery function returns the destination (if successful) to chain them:\n\n This creates an intermediate *.tar* file! Use ``delete_source=True`` to delete it afterwards.\n\n.. code-block:: python\n\n >>> from xtract import tar, gzip\n >>> gzip(\n >>> tar('my-directory', ['file1.txt', 'file2.txt']),\n >>> delete_source=True\n >>> )\n '/home//my-directory.tar.gz'\n\n\nSee the `manual `_\nfor more examples.\n\n\nLicense\n=======\n\nCopyright (c) 2017 Mathias Stelzer\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program. If not, see .\n\n\n.. |pipeline| image:: https://rolln.de/knoppo/xtract/badges/master/pipeline.svg\n.. _pipeline: https://rolln.de/knoppo/xtract/commits/master\n.. |coverage| image:: https://rolln.de/knoppo/xtract/badges/master/coverage.svg\n.. _coverage: https://rolln.de/knoppo/xtract/commits/master\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://rolln.de/knoppo/xtract", "keywords": "xtract extract unpack pack archive compress decompress zip rar tar gz gzip bz bzip bz2 bzip2 xzmagic python-magic", "license": "GNU GPLv3+", "maintainer": "", "maintainer_email": "", "name": "xtract", "package_url": "https://pypi.org/project/xtract/", "platform": "", "project_url": "https://pypi.org/project/xtract/", "project_urls": { "Homepage": "https://rolln.de/knoppo/xtract" }, "release_url": "https://pypi.org/project/xtract/0.1a3/", "requires_dist": [ "python-magic" ], "requires_python": "", "summary": "Library to (un)pack archives and (de)compress files", "version": "0.1a3" }, "last_serial": 3454315, "releases": { "0.1a3": [ { "comment_text": "", "digests": { "md5": "1dcb91afe513d7e15a7f9c05d928fe1d", "sha256": "e085b268480f2123d1f7e25411a13721e987cfa064447afdbe895949cfe2899a" }, "downloads": -1, "filename": "xtract-0.1a3-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "1dcb91afe513d7e15a7f9c05d928fe1d", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 13772, "upload_time": "2018-01-01T12:04:56", "url": "https://files.pythonhosted.org/packages/37/74/2d74c59ae912dc9336d87e2ff16fa09c9d2f8b4abdd11c5c9d6770948add/xtract-0.1a3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ff7e03eb560f1a36230f3b32f43082e4", "sha256": "1baac33be7494a106233e0db9de8d3ccc743635092a9b134641151c71bc322e3" }, "downloads": -1, "filename": "xtract-0.1a3.tar.gz", "has_sig": true, "md5_digest": "ff7e03eb560f1a36230f3b32f43082e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20926, "upload_time": "2018-01-01T12:05:00", "url": "https://files.pythonhosted.org/packages/35/75/e5f69665d910be47838cb95bd534f7ca1c47faf47dec147533b94433a13d/xtract-0.1a3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1dcb91afe513d7e15a7f9c05d928fe1d", "sha256": "e085b268480f2123d1f7e25411a13721e987cfa064447afdbe895949cfe2899a" }, "downloads": -1, "filename": "xtract-0.1a3-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "1dcb91afe513d7e15a7f9c05d928fe1d", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 13772, "upload_time": "2018-01-01T12:04:56", "url": "https://files.pythonhosted.org/packages/37/74/2d74c59ae912dc9336d87e2ff16fa09c9d2f8b4abdd11c5c9d6770948add/xtract-0.1a3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ff7e03eb560f1a36230f3b32f43082e4", "sha256": "1baac33be7494a106233e0db9de8d3ccc743635092a9b134641151c71bc322e3" }, "downloads": -1, "filename": "xtract-0.1a3.tar.gz", "has_sig": true, "md5_digest": "ff7e03eb560f1a36230f3b32f43082e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20926, "upload_time": "2018-01-01T12:05:00", "url": "https://files.pythonhosted.org/packages/35/75/e5f69665d910be47838cb95bd534f7ca1c47faf47dec147533b94433a13d/xtract-0.1a3.tar.gz" } ] }