{ "info": { "author": "Chris Davies", "author_email": "chris@packagr.app", "bugtrack_url": null, "classifiers": [ "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.7" ], "description": "# Packagr CLI\n\n## What is Packagr?\n\n[Packagr](https://www.packagr.app) is a cloud hosted private repository for your private Python packages. The Packagr\nCLI is a separate, open source project intended to support it by allowing you to perform most of Packagr's functionality\nvia the API \n\n## Installation\n\nPackagr CLI can be installed via pip:\n\n```bash\npip install packagr-cli\n```\n\nIt can then be invoked via the `packagr` command in any terminal window:\n\n```bash\npackagr [command] [args]\n```\n\n## Commands\n\n### Configure\n`packagr configure `\n\nYou should call the `configure` command straight after you install Packagr CLI. This command will store your credentials\nto a config file, `packagr_conf.toml`, that is referenced by many other of the Packagr CLI commands, and removes the\nneed for the Packagr CLI to contstantly prompt you for your password (as is the case with `pip`/`twine`)\n\n#### Parameters\n\n- `hash-id`: See below\n- `email`: The email address you registered for Packagr with\n- `password`: The password you registered for Packagr with\n\n#### Where do I get my Packagr hash id?\n\nWhen you first sign up for a [Packagr](https://www.packagr.app) account, you'll be assigned a unique repository url that\nlooks something like this:\n\n```bash\nhttps://api.packagr.app/u893rj/\n```\n\nThe last part of this url is your `hash-id`\n\n### Init \n`packagr init [--overwrite]`\n\nIn order to create a Package, Packagr needs a file called `packagr.toml`, which contains information about your package.\nThe `package init` command creates this file for you\n\nThe `name` argument is optional - if not specified, the name will default to the name of the folder you invoke the call\nfrom. \n\nAdditionally, the `init` command will also create a subfolder called `name`, if one doesn't already exist. By default,\nPackagr assumes that the code you want to package is stored in this folder. However, if you want to customize that, you\ncan easily do so by editing the `packages` parameter in `packagr.toml`. It's also possible to modify any of the valuues\nin the config file manually.\n\n#### Arguments\n\n- `name` (Optional): The name of your package\n- `--overwrite` (Optional): If you try to run `packagr init` in a folder where a `packagr.toml` file already exists, you\n will be prompted to confirm that you want to overwrite the existing file. Passing this argument overrides the prompt\n\n### Set\n`packagr set `\n\nOnce your `packagr.toml` file has been created, you can use the `set` command to set values within it. For example, if \nyou wanted to add a description to the config, you could enter the following command:\n\n```bash\npackagr set description \"some information\"\n```\n\nYou could equally just go into your `packagr.toml` file and add the line `description = \"some information\"` manually,\nbut the recommended way is to use the CLI - eventually, the CLI will validate the value of `key` to ensure that it is\nvalid.\n\nIf you enter a duplicate key, you will be prompted to confirm that you want to overwrite it\n\n#### Arguments\n\n- `key`: the setting key\n- `value`: the setting value\n\n### Add\n`packagr add `\n\nThe `add` command works in a similar way to the `set` command, but it's purpose is to append data to arrays already \ndefined in the config. For example, if your config already looks like this:\n\n```toml\nAuthors = ['Chris '] \n```\n\nThen you can update this value using `packagr add Authors \"some guy \"` to change it to the following:\n\n```toml\nAuthors = [ \"Chris \", \"Some guy \",]\n```\n\nThe `add` command will also add a value to a key that doesn't exist.\n\n#### Arguments\n\n- `key`: the setting key\n- `value`: the setting value\n\n\n### Install\n`packagr install `\n\nThe `install` command works in a similar way to `pip install` - it installs a package using your current environment's\n`pip` installation. However, this command will also look for packages in your Packagr repository, as well as in the \npublic PyPI repository. Once a package is installed correctly, it will also be added to your config's `install_requires`\nsection\n\n#### Arguments\n\n- `packages`: a list of packages to install\n- `--ignore-errors`: In case of multiple packages, passing this argument means that Packagr will continue attempting to\n install the remaining packages on the list in the case that one fails\n\n### Uninstall\n`packagr uninstall `\n\n\nThis command does the opposite of `install` - it uninstalls a given package and removes it from the dependencies list.\n\n#### Arguments\n\n- `packages`: a list of packages to uninstall\n- `--ignore-errors`: In case of multiple packages, passing this argument means that Packagr will continue attempting to\n \n \n### Bump\n`packagr bump [--minor] [--major]`\n\nThe `bump` command increases the version number of your package. Used without arguments, e.g. `packagr bump`, it \nincreases the version number, e.g. `1.0.0` becomes `1.0.0`. Using the `--minor` argument increases the minor version\nnumber, e.g. `1.0.0 > 1.1.0` and the `--major` argument converts `1.0.0` to `2.0.0`. The `--major` and `--minor` \narguments can be used in conjuction with each other.\n\nAlternatively, you can use `packagr bump 4.5.6` to set the version for a specific value. If you aren't using `semver`,\nwhich means that the `bump` command may not be able to parse the existing version number, then you can use this option\ninstead\n\n#### Arguments\n\n- `version` (optional): the version number to set. Not compatible with any other argument\n- `--minor` (optional): Increase the minor version number\n- `--major` (optional): Increase the major version number\n\n\n### Package\n`packagr package`\n\nCreates `sdist` and/or `wheel` packages based on your config file. Using the command without arguments will create a \npackage in both formats. Using `--no-wheel` or `no-sdist` will prevent creation of specific formats\n\n#### Arguments\n- `--no-sdist`: Don't build a tarball\n- `--no-wheel`: Don't build a wheel\n\n\n### Upload\n`packagr upload [--ignore-409]`\n\nThis command will push your package to Packagr. If you are uploading many packages at once, you may opt to use the \n`--ignore-409` argument, which will skip to the next package if encountering a 409 error (conflict for URL). In future,\nPackagr CLI will have the ability to display detailed logs from Packagr, which offers a big advantage over `twine`'s\nlimited ability to handle error responses\n\n### Create token\n`packagr create-token [--write-access]`\n\nThis command creates an access token for a given package and user. If the `--write-access` flag is provided, then the \ncreated token will have write access.\n\n### Delete token\n`packagr token delete `\n\nThis command deletes an access token for a given package and user.\n\n### Coming soon\n\nThe following commands will be added to future versions of Packagr CLI:\n\n- ``packagr set-readme ``: passes the content of a readme file to `Description`\n- ``packagr set-public ``: Sets a package as `public`\n- ``packagr set-private ``: Sets a package as `private`\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "", "license": "", "maintainer": "Chris Davies", "maintainer_email": "chris@packagr.app", "name": "packagr-cli", "package_url": "https://pypi.org/project/packagr-cli/", "platform": "", "project_url": "https://pypi.org/project/packagr-cli/", "project_urls": null, "release_url": "https://pypi.org/project/packagr-cli/0.3.0/", "requires_dist": [ "cleo (>=0.7.2,<0.8.0)", "toml (>=0.10.0,<0.11.0)", "wheel (>=0.33.1,<0.34.0)", "requests (>=2.21,<3.0)" ], "requires_python": ">=3.6.2,<4.0.0", "summary": "A CLI for https://www.packagr.app", "version": "0.3.0" }, "last_serial": 4968579, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "6ec0f5d16547618a09384c9f13ffb007", "sha256": "d51561807bb41dc9e2204171ebe20d8a7983a435b4f1367fe7f52f3d082d0fc6" }, "downloads": -1, "filename": "packagr_cli-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "6ec0f5d16547618a09384c9f13ffb007", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.2,<4.0.0", "size": 19189, "upload_time": "2019-03-14T17:17:27", "url": "https://files.pythonhosted.org/packages/89/a5/a1b797067fe280a34e9e1cbf3e95848c78a87fbbf7c4a52e4182310c7405/packagr_cli-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "69da58680e6d3175f7f709219b767e0e", "sha256": "e088b8240a44d8078a3221b6ba192c19495ada28b2f87e508b0857014b32a437" }, "downloads": -1, "filename": "packagr-cli-0.1.1.tar.gz", "has_sig": false, "md5_digest": "69da58680e6d3175f7f709219b767e0e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.2,<4.0.0", "size": 9954, "upload_time": "2019-03-14T17:17:26", "url": "https://files.pythonhosted.org/packages/69/06/4d9ac5ee158427302bc59c177f08948383f8601453cc7bb0580947db8897/packagr-cli-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "565832d060602135d4bc4be77c391e54", "sha256": "ab5cdf60b02147f04f5f11839dfaeaf34ace8cdb2e269be07d146eec4573a34e" }, "downloads": -1, "filename": "packagr_cli-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "565832d060602135d4bc4be77c391e54", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.2,<4.0.0", "size": 6414207, "upload_time": "2019-03-19T12:51:45", "url": "https://files.pythonhosted.org/packages/cf/1e/c7b73e933f772c4312bd20688ae459f4636fd34a78e87a3dd84406f8c315/packagr_cli-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5e0026c604163763a5a078076ddafc8d", "sha256": "165505ba9d661aa6b21817c7eac71ca2a6585965d25ee194bde1b637a35ecf65" }, "downloads": -1, "filename": "packagr-cli-0.2.0.tar.gz", "has_sig": false, "md5_digest": "5e0026c604163763a5a078076ddafc8d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.2,<4.0.0", "size": 363944, "upload_time": "2019-03-19T12:51:42", "url": "https://files.pythonhosted.org/packages/ab/1f/6020ce2f29d3038b5384f76d7bedaf3d21123df34900623288c79ce0489c/packagr-cli-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "7caf0b9f547ba7c7a97b029ed6f3f702", "sha256": "5dc06e4a40e3862da115b02c92712c84ae3c8859fd55d03a9bcc69f35598fa6b" }, "downloads": -1, "filename": "packagr_cli-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7caf0b9f547ba7c7a97b029ed6f3f702", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.2,<4.0.0", "size": 6423887, "upload_time": "2019-03-21T15:08:53", "url": "https://files.pythonhosted.org/packages/4f/d3/9439cdcfe41e6f11de7a2e37fd95aa5dfa1d1253fcea2c4e1143681e62ce/packagr_cli-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc6dae715836003d13b187f5758bb4b2", "sha256": "72594c3c8ee530e9e919b318eb41752a8a9a7018f763e62a6bba5e7d8d899075" }, "downloads": -1, "filename": "packagr-cli-0.3.0.tar.gz", "has_sig": false, "md5_digest": "bc6dae715836003d13b187f5758bb4b2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.2,<4.0.0", "size": 365853, "upload_time": "2019-03-21T15:08:50", "url": "https://files.pythonhosted.org/packages/69/e4/0fbe9ced6fd034c779bb0696fa0e5ed12a258d80351a46a550d6754d3f39/packagr-cli-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "7caf0b9f547ba7c7a97b029ed6f3f702", "sha256": "5dc06e4a40e3862da115b02c92712c84ae3c8859fd55d03a9bcc69f35598fa6b" }, "downloads": -1, "filename": "packagr_cli-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7caf0b9f547ba7c7a97b029ed6f3f702", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.2,<4.0.0", "size": 6423887, "upload_time": "2019-03-21T15:08:53", "url": "https://files.pythonhosted.org/packages/4f/d3/9439cdcfe41e6f11de7a2e37fd95aa5dfa1d1253fcea2c4e1143681e62ce/packagr_cli-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc6dae715836003d13b187f5758bb4b2", "sha256": "72594c3c8ee530e9e919b318eb41752a8a9a7018f763e62a6bba5e7d8d899075" }, "downloads": -1, "filename": "packagr-cli-0.3.0.tar.gz", "has_sig": false, "md5_digest": "bc6dae715836003d13b187f5758bb4b2", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.2,<4.0.0", "size": 365853, "upload_time": "2019-03-21T15:08:50", "url": "https://files.pythonhosted.org/packages/69/e4/0fbe9ced6fd034c779bb0696fa0e5ed12a258d80351a46a550d6754d3f39/packagr-cli-0.3.0.tar.gz" } ] }