{ "info": { "author": "Mike McKerns", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering", "Topic :: Software Development" ], "description": "--------------------------------------------------------------\npox: utilities for filesystem exploration and automated builds\n--------------------------------------------------------------\n\nAbout Pox\n=========\n\n``pox`` provides a collection of utilities for navigating and manipulating\nfilesystems. This module is designed to facilitate some of the low level\noperating system interactions that are useful when exploring a filesystem\non a remote host, where queries such as *\"what is the root of the filesystem?\"*,\n*\"what is the user's name?\"*, and *\"what login shell is preferred?\"* become\nessential in allowing a remote user to function as if they were logged in\nlocally. While ``pox`` is in the same vein of both the ``os`` and ``shutil``\nbuiltin modules, the majority of its functionality is unique and compliments\nthese two modules.\n\n``pox`` provides python equivalents of several unix shell commands such as\n``which`` and ``find``. These commands allow automated discovery of what has\nbeen installed on an operating system, and where the essential tools are\nlocated. This capability is useful not only for exploring remote hosts,\nbut also locally as a helper utility for automated build and installation.\n\nSeveral high-level operations on files and filesystems are also provided.\nExamples of which are: finding the location of an installed python package,\ndetermining if and where the source code resides on the filesystem, and\ndetermining what version the installed package is.\n\n``pox`` also provides utilities to enable the abstraction of commands sent\nto a remote filesystem. In conjunction with a registry of environment\nvariables and installed utilites, ``pox`` enables the user to interact with\na remote filesystem as if they were logged in locally. \n\n``pox`` is part of ``pathos``, a python framework for heterogeneous computing.\n``pox`` is in active development, so any user feedback, bug reports, comments,\nor suggestions are highly appreciated. A list of known issues is maintained\nat http://trac.mystic.cacr.caltech.edu/project/pathos/query.html, with a public\nticket list at https://github.com/uqfoundation/pox/issues.\n\n\nMajor Features\n==============\n\n``pox`` provides utilities for discovering the user's environment:\n\n - return the user's name, current shell, and path to user's home directory\n - strip duplicate entries from the user's ``$PATH``\n - lookup and expand environment variables from ``${VAR}`` to ``value``\n\n``pox`` also provides utilities for filesystem exploration and manipulation:\n\n - discover the path to a file, exectuable, directory, or symbolic link \n - discover the path to an installed package\n - parse operating system commands for remote shell invocation\n - convert text files to platform-specific formatting\n\n\nCurrent Release\n===============\n\nThis documentation is for version ``pox-0.2.7``.\n\nThe latest released version of ``pox`` is available from:\n\n https://pypi.org/project/pox\n\n``pox`` is distributed under a 3-clause BSD license.\n\n >>> import pox\n >>> print (pox.license())\n\n\nDevelopment Version\n===================\n\nYou can get the latest development version with all the shiny new features at:\n\n https://github.com/uqfoundation\n\nIf you have a new contribution, please submit a pull request.\n\n\nInstallation\n============\n\n``pox`` is packaged to install from source, so you can\ndownload the tarball, unzip, and run the installer::\n\n [download]\n $ tar -xvzf pox-0.2.7.tar.gz\n $ cd pox-0.2.7\n $ python setup py build\n $ python setup py install\n\nYou will be warned of any missing dependencies and/or settings\nafter you run the \"build\" step above. \n\nAlternately, ``pox`` can be installed with ``pip`` or ``easy_install``::\n\n $ pip install pox\n\n\nRequirements\n============\n\n``pox`` requires:\n\n - ``python``, **version >= 2.5** or **version >= 3.1**, or ``pypy``\n\nOptional requirements:\n\n - ``setuptools``, **version >= 0.6**\n\n\nMore Information\n================\n\nProbably the best way to get started is to look at the documentation at\nhttp://pox.rtfd.io. Also see ``pox.tests`` for a set of scripts that demonstrate\nhow ``pox`` can be used to interact with the operating system. You can run the\ntest suite with ``python -m pox.tests``. All ``pox`` utilities\ncan be launched directly from an operating system terminal, using the ``pox``\nscript (or with ``python -m pox``). The source code is also generally well\ndocumented, so further questions may be resolved by inspecting the code\nitself. Please feel free to submit a ticket on github, or ask a\nquestion on stackoverflow (**@Mike McKerns**).\nIf you would like to share how you use ``pox`` in your work, please send an\nemail (to **mmckerns at uqfoundation dot org**).\n\n\nCitation\n========\n\nIf you use ``pox`` to do research that leads to publication, we ask that you\nacknowledge use of ``pox`` by citing the following in your publication::\n\n M.M. McKerns, L. Strand, T. Sullivan, A. Fang, M.A.G. Aivazis,\n \"Building a framework for predictive science\", Proceedings of\n the 10th Python in Science Conference, 2011;\n http://arxiv.org/pdf/1202.1056\n\n Michael McKerns and Michael Aivazis,\n \"pathos: a framework for heterogeneous computing\", 2010- ;\n http://trac.mystic.cacr.caltech.edu/project/pathos\n\nPlease see http://trac.mystic.cacr.caltech.edu/project/pathos or\nhttp://arxiv.org/pdf/1202.1056 for further information.", "description_content_type": "", "docs_url": null, "download_url": "https://github.com/uqfoundation/pox/releases/download/pox-0.2.7/pox-0.2.7.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://pypi.org/project/pox", "keywords": "", "license": "3-clause BSD", "maintainer": "", "maintainer_email": "", "name": "pox", "package_url": "https://pypi.org/project/pox/", "platform": "Linux", "project_url": "https://pypi.org/project/pox/", "project_urls": { "Download": "https://github.com/uqfoundation/pox/releases/download/pox-0.2.7/pox-0.2.7.tar.gz", "Homepage": "https://pypi.org/project/pox" }, "release_url": "https://pypi.org/project/pox/0.2.7/", "requires_dist": null, "requires_python": "", "summary": "utilities for filesystem exploration and automated builds", "version": "0.2.7" }, "last_serial": 5899791, "releases": { "0.1a1": [ { "comment_text": "", "digests": { "md5": "76cfb607cd4418ffdada501d7435b92e", "sha256": "e78f93b790cb713da6c6a59dbb0e5e56a8d6e6fd5b69f44fd45b577468c3e373" }, "downloads": -1, "filename": "pox-0.1a1.tgz", "has_sig": false, "md5_digest": "76cfb607cd4418ffdada501d7435b92e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14806, "upload_time": "2015-12-22T20:24:18", "url": "https://files.pythonhosted.org/packages/25/5d/5ebd632cba59ed4c6f955723da8fd1aaabb848fb0d54ae570ded10981c86/pox-0.1a1.tgz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "08bce5cc94bbb3384890ce14b6e565a8", "sha256": "ecad525c3497b62fff764b4b21eaeb428dfd7465a3fc0ec6fb54b0ec9c18c06d" }, "downloads": -1, "filename": "pox-0.2.tgz", "has_sig": false, "md5_digest": "08bce5cc94bbb3384890ce14b6e565a8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22098, "upload_time": "2014-05-19T16:26:53", "url": "https://files.pythonhosted.org/packages/d2/c2/5880aa62f30a47a371b690618632f6731d9cb777bd9ee5046b199b9c673a/pox-0.2.tgz" }, { "comment_text": "", "digests": { "md5": "7258d4d5b6830c2c3632330bf8efa6af", "sha256": "330021f3156aab98d603efbac831682c15bafcc9becc70764f175f6d3f00392c" }, "downloads": -1, "filename": "pox-0.2.zip", "has_sig": false, "md5_digest": "7258d4d5b6830c2c3632330bf8efa6af", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38405, "upload_time": "2014-05-19T16:26:44", "url": "https://files.pythonhosted.org/packages/99/09/1791c1525bec9e5e83693fa1cf7a5cf6168937d55249ab91eae8868f1b7a/pox-0.2.zip" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "4f147a2d39ff122daed78e33acba00ec", "sha256": "c94f2ea4d6ad15ef06d3ade03499bf819d587344ac1dab6f4b7194d12c41d83d" }, "downloads": -1, "filename": "pox-0.2.1.tgz", "has_sig": false, "md5_digest": "4f147a2d39ff122daed78e33acba00ec", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23528, "upload_time": "2014-11-25T19:40:41", "url": "https://files.pythonhosted.org/packages/75/42/d7a3e9595d1b046c57c687e7260eeb962cbd1bbda563a3a3f30f13aea6f4/pox-0.2.1.tgz" }, { "comment_text": "", "digests": { "md5": "517dc13c2bc2429d36a0c636f3ce42db", "sha256": "580bf731fee233c58eac0974011b5bf0698efb7337b0a1696d289043b4fcd7f4" }, "downloads": -1, "filename": "pox-0.2.1.zip", "has_sig": false, "md5_digest": "517dc13c2bc2429d36a0c636f3ce42db", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39889, "upload_time": "2014-11-25T19:40:12", "url": "https://files.pythonhosted.org/packages/77/af/cb61d7572b804b82ff32dedc16e879af3247bc0ab2fefd2ca039e427bbc3/pox-0.2.1.zip" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "4c50ed714b8661550639dbac9b3c18f4", "sha256": "22e97ac6d2918c754e65a9581dbe02e9d00ae4a54ca48d05118f87c1ea92aa19" }, "downloads": -1, "filename": "pox-0.2.2.tgz", "has_sig": false, "md5_digest": "4c50ed714b8661550639dbac9b3c18f4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23628, "upload_time": "2015-07-29T00:49:24", "url": "https://files.pythonhosted.org/packages/6d/ae/40f02d47cdb88363ec7eb3d0851805053dbee95a2710532f7e4955babc3b/pox-0.2.2.tgz" }, { "comment_text": "", "digests": { "md5": "e1e2ce99a63d7226ea3c1a2ce389610d", "sha256": "c0b88e59ef0e4f2fa4839e11bf90d2c32d6ceb5abaf01f0c8138f7558e6f87c1" }, "downloads": -1, "filename": "pox-0.2.2.zip", "has_sig": false, "md5_digest": "e1e2ce99a63d7226ea3c1a2ce389610d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 40120, "upload_time": "2015-07-29T00:49:02", "url": "https://files.pythonhosted.org/packages/13/b4/eaccb63721a8e5488f0732276fa83c722a0780a3b1cbb523ecd6f75d2829/pox-0.2.2.zip" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "fcdfd9a9ab0f72367258b675554f6a83", "sha256": "d3e8167a1ebe08ae56262a0b9359118d90bc4648cd284b5d10ae240343100a75" }, "downloads": -1, "filename": "pox-0.2.3.zip", "has_sig": false, "md5_digest": "fcdfd9a9ab0f72367258b675554f6a83", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41244, "upload_time": "2017-02-01T18:02:49", "url": "https://files.pythonhosted.org/packages/1e/27/effa6e207856eb60dd86bfe0a1954460b911cd88978450ee8a37a4b7826f/pox-0.2.3.zip" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "8ffdc1709f45da3038e688beea8a2f50", "sha256": "9c8955d9beed4f9fd509587d17820efe6bc9f9b4a1abe581642aeed9a41784ea" }, "downloads": -1, "filename": "pox-0.2.4.tar.gz", "has_sig": false, "md5_digest": "8ffdc1709f45da3038e688beea8a2f50", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 109157, "upload_time": "2018-06-21T01:21:38", "url": "https://files.pythonhosted.org/packages/7d/a2/aff99902359ee6e59f5a7846b5d0ce52389c17587d80ea68ef63ca6530cc/pox-0.2.4.tar.gz" } ], "0.2.5": [ { "comment_text": "", "digests": { "md5": "df33f1243aee739621a4af20d8c2946a", "sha256": "2b53fbdf02596240483dc2cb94f94cc21252ad1b1858c7b1c151afeec9022cc8" }, "downloads": -1, "filename": "pox-0.2.5.tar.gz", "has_sig": false, "md5_digest": "df33f1243aee739621a4af20d8c2946a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 109356, "upload_time": "2019-01-21T16:15:16", "url": "https://files.pythonhosted.org/packages/d7/4d/56db34aac51e9bb2005cf7fffabbd1d7a7d18b42fe6ccb05ffae571d356b/pox-0.2.5.tar.gz" } ], "0.2.6": [ { "comment_text": "", "digests": { "md5": "22e22fef6ba648186a45417a52529724", "sha256": "47cb160322922c54590be447f08aa43f04875a3e53eee89963a757ebb5eb1376" }, "downloads": -1, "filename": "pox-0.2.6.tar.gz", "has_sig": false, "md5_digest": "22e22fef6ba648186a45417a52529724", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 110221, "upload_time": "2019-06-26T22:20:09", "url": "https://files.pythonhosted.org/packages/b0/8e/e8095866c3b512f9ef844ad20669e0c4785da1784dcfd282377896ffd3b1/pox-0.2.6.tar.gz" } ], "0.2.7": [ { "comment_text": "", "digests": { "md5": "13a180338690e20d9678d5fb52bbac53", "sha256": "06afe1a4a1dbf8b47f7ad5a3c1d8ada9104c64933a1da11338269a2bd8642778" }, "downloads": -1, "filename": "pox-0.2.7.tar.gz", "has_sig": false, "md5_digest": "13a180338690e20d9678d5fb52bbac53", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 110294, "upload_time": "2019-09-28T14:20:21", "url": "https://files.pythonhosted.org/packages/6c/9a/957818485aa165ce93b646aeb20181215bb415c9dca8345bdbe23b08ae67/pox-0.2.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "13a180338690e20d9678d5fb52bbac53", "sha256": "06afe1a4a1dbf8b47f7ad5a3c1d8ada9104c64933a1da11338269a2bd8642778" }, "downloads": -1, "filename": "pox-0.2.7.tar.gz", "has_sig": false, "md5_digest": "13a180338690e20d9678d5fb52bbac53", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 110294, "upload_time": "2019-09-28T14:20:21", "url": "https://files.pythonhosted.org/packages/6c/9a/957818485aa165ce93b646aeb20181215bb415c9dca8345bdbe23b08ae67/pox-0.2.7.tar.gz" } ] }