{ "info": { "author": "Gigaspaces", "author_email": "cosmo-admin@gigaspaces.com", "bugtrack_url": null, "classifiers": [], "description": "Wheelr\n======\n\nThis tool creates tar.gz based Python Wheel archives for single modules\nand allows to install them.\n\n(NOTE: Currently, only tested on Linux).\n\nCloudify Plugins are packaged as sets of Python\n`Wheels `__\nin tar.gz files and so we needed a tool to create such archives. Hence,\nWheelr.\n\nUsage\n-----\n\nCreate Packages\n~~~~~~~~~~~~~~~\n\n.. code:: shell\n\n wheelr create --help\n\nExamples\n^^^^^^^^\n\n.. code:: shell\n\n # create an archive by retrieving the source from PyPI and keep the downloaded wheels (kept under /plugin)\n wheelr create -s cloudify-script-plugin==1.2 --keep-wheels -v\n # create an archive package by retrieving the source from a URL and creates wheels from requirement files found within the archive.\n wheelr create -s http://github.com/cloudify-cosmo/cloudify-script-plugin/archive/1.2.tar.gz -r .\n # create an archive package by retrieving the source from a local path and output the tar.gz file to /tmp/.tar.gz (defaults to /.tar.gz)\n wheelr create -s ~/modules/cloudify-script-plugin/ -o /tmp/\n\nThe output package of the three commands should be something like\n``cloudify_script_plugin-1.2-py27-none-any.tar.gz`` if running under\nPython 2.7.x.\n\nInstall Packages\n~~~~~~~~~~~~~~~~\n\n.. code:: shell\n\n wheelr install --help\n\nExamples\n^^^^^^^^\n\n.. code:: shell\n\n # install a packaged module from a local package tar file and upgrade if already installed\n wheelr install -s ~/tars/cloudify_script_plugin-1.2-py27-none-any.tar.gz --upgrade\n # install a packaged module from a url into an existing virtualenv\n wheelr install -s http://me.com/cloudify_script_plugin-1.2-py27-none-any.tar.gz --virtualenv my_venv -v\n\nNaming and Versioning\n---------------------\n\nSource: PyPI\n~~~~~~~~~~~~\n\nWhen providing a PyPI source, it must be supplied as\nMODULE\\_NAME==MODULE\\_VERSION. Wheelr then applies the correct name and\nversion to the archive according to the two parameters.\n\nSource: Else\n~~~~~~~~~~~~\n\nFor local path and URL sources, the name and version are automatically\nextracted from the setup.py file.\n\nNOTE: This means that when supplying a local path, you must supply a\npath to the root of where your setup.py file resides.\n\nMetadata File and Wheels\n------------------------\n\nA Metadata file is generated for the archive and looks somewhat like\nthis:\n\n::\n\n {\n \"archive_name\": \"cloudify_script_plugin-1.2-py27-none-any.tar.gz\",\n \"supported_platform\": \"any\",\n \"module_name\": \"cloudify-script-plugin\",\n \"module_source\": \"cloudify-script-plugin==1.2\",\n \"module_version\": \"1.2\",\n \"wheels\": [\n \"proxy_tools-0.1.0-py2-none-any.whl\",\n \"bottle-0.12.7-py2-none-any.whl\",\n \"networkx-1.8.1-py2-none-any.whl\",\n \"pika-0.9.13-py2-none-any.whl\",\n \"cloudify_plugins_common-3.2.1-py2-none-any.whl\",\n \"requests-2.7.0-py2.py3-none-any.whl\",\n \"cloudify_rest_client-3.2.1-py2-none-any.whl\",\n \"cloudify_script_plugin-1.2-py2-none-any.whl\"\n ]\n }\n\n- The wheels to be installed reside in the tar.gz file under\n 'wheels/\\*.whl'.\n- The Metadata file resides in the tar.gz file under 'module.json'.\n- The installer uses the metadata file to check that the platform fits\n the machine the module is being installed on.\n\nArchive naming convention and Platform\n--------------------------------------\n\nThe tar.gz archive is named according to the Wheel naming convention\ndescribed in\n`PEP0427 `__\naside from two fields:\n\nExample: ``cloudify_fabric_plugin-1.2.1-py27-none-linux_x86_64.tar.gz``\n\n- ``{python tag}``: The Python version is set by the Python running the\n packaging process. That means that while a module might run on both\n py27 and py33 (for example), since the packaging process took place\n using Python 2.7, only py27 will be appended to the name. Note that\n we will be providing a way for the user to provide the supported\n Python versions explicitly.\n- ``{platform tag}``: The platform (e.g. ``linux_x86_64``, ``win32``)\n is set for a specific wheel. To know which platform the module can be\n installed on, all wheels are checked. If a specific wheel has a\n platform property other than ``any``, that platform will be used as\n the platform of the package. Of course, we assume that there can't be\n wheels downloaded or created on a specific machine platform that\n belongs to two different platforms.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/cloudify-cosmo/wheelr", "keywords": null, "license": "LICENSE", "maintainer": null, "maintainer_email": null, "name": "wheelr", "package_url": "https://pypi.org/project/wheelr/", "platform": "All", "project_url": "https://pypi.org/project/wheelr/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/cloudify-cosmo/wheelr" }, "release_url": "https://pypi.org/project/wheelr/0.1.1/", "requires_dist": null, "requires_python": null, "summary": "Creates Python Wheel Archives.", "version": "0.1.1" }, "last_serial": 1732115, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "198dbef3d8fcf3aace9a2f5608ae1304", "sha256": "b958bc4dd4f690e24cf134ce9e4d572e1de3bcb03f749eff179a3c5ba2dbfca1" }, "downloads": -1, "filename": "wheelr-0.1.tar.gz", "has_sig": false, "md5_digest": "198dbef3d8fcf3aace9a2f5608ae1304", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22281, "upload_time": "2015-09-10T19:01:56", "url": "https://files.pythonhosted.org/packages/88/0e/25e3475edb05ec95e97502064d06ee650522ab1b11015db1a681b02e1a52/wheelr-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "3bbca770c0140431deaa73af0abccbb5", "sha256": "2c61a1cdc790d5fd1fc59c0191ba7b113b2d31942cc289e8a8e1de67b255f7cd" }, "downloads": -1, "filename": "wheelr-0.1.1.tar.gz", "has_sig": false, "md5_digest": "3bbca770c0140431deaa73af0abccbb5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22406, "upload_time": "2015-09-21T18:50:12", "url": "https://files.pythonhosted.org/packages/9b/c8/649181d5c5b5b3b7d067a30627eb0ef1a3ae63416757a9fa5838d5dfabd6/wheelr-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3bbca770c0140431deaa73af0abccbb5", "sha256": "2c61a1cdc790d5fd1fc59c0191ba7b113b2d31942cc289e8a8e1de67b255f7cd" }, "downloads": -1, "filename": "wheelr-0.1.1.tar.gz", "has_sig": false, "md5_digest": "3bbca770c0140431deaa73af0abccbb5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22406, "upload_time": "2015-09-21T18:50:12", "url": "https://files.pythonhosted.org/packages/9b/c8/649181d5c5b5b3b7d067a30627eb0ef1a3ae63416757a9fa5838d5dfabd6/wheelr-0.1.1.tar.gz" } ] }