{ "info": { "author": "mogproject", "author_email": "mogproj@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "============\nartifact-cli\n============\n\nPrivate Artifact Manager using Amazon S3\n\n.. image:: https://badge.fury.io/py/artifact-cli.svg\n :target: http://badge.fury.io/py/artifact-cli\n :alt: PyPI version\n\n.. image:: https://travis-ci.org/mogproject/artifact-cli.svg?branch=master\n :target: https://travis-ci.org/mogproject/artifact-cli\n :alt: Build Status\n\n\n.. image:: https://coveralls.io/repos/mogproject/artifact-cli/badge.png?branch=master\n :target: https://coveralls.io/r/mogproject/artifact-cli?branch=master\n :alt: Coverage Status\n\n.. image:: https://img.shields.io/badge/license-Apache%202.0-blue.svg\n :target: http://choosealicense.com/licenses/apache-2.0/\n :alt: License\n\n.. image:: https://badge.waffle.io/mogproject/artifact-cli.svg?label=ready&title=Ready\n :target: https://waffle.io/mogproject/artifact-cli\n :alt: 'Stories in Ready' \n\n--------\nFeatures\n--------\n\n* Easy & lightweight artifact manager for Java/Scala\n\n * Especially optimized for all-in-one package (e.g. the result of ``sbt dist`` or ``sbt assembly``)\n\n* No database or extra servers needed except Amazon S3\n* Quite simple command line interface (CLI)\n* Integrate your daily build & deploy tasks\n\n------------\nDependencies\n------------\n\n* Python 2.6 / 2.7\n* pytz\n* python-dateutil\n* GitPython >= 0.3.5\n* boto >= 2.38.0\n* moto (for testing)\n\n------------\nInstallation\n------------\n\n* ``pip`` command may need ``sudo``\n\n+-------------------------+------------------------------------------+\n| Operation | Command |\n+=========================+==========================================+\n| Install |``pip install artifact-cli`` |\n+-------------------------+------------------------------------------+\n| Upgrade |``pip install --upgrade artifact-cli`` |\n+-------------------------+------------------------------------------+\n| Uninstall |``pip uninstall artifact-cli`` |\n+-------------------------+------------------------------------------+\n| Check installed version |``artifact-cli --version`` |\n+-------------------------+------------------------------------------+\n| Help |``artifact-cli -h`` |\n+-------------------------+------------------------------------------+\n\n----------------\nQuickstart Guide\n----------------\n\n1. Create your Amazon Web Services account (if need)\n----------------------------------------------------\n\nThe responsibility of the AWS's charge is your own.\n\n2. Create IAM User to access Amazon S3 (if need)\n------------------------------------------------\n\nManage your own **access key ID** and **secret access key** to call the APIs.\n\n3. Create Amazon S3 bucket\n--------------------------\n\nSet permissions to the IAM user.\n\n4. Make configuration file\n--------------------------\n\nCreate ``~/.artifact-cli`` file and write credentials for AWS like this:\n\n.. code-block:: ini\n\n [default]\n aws_access_key_id = XXXXXXXXXXXXXXXXXXXX\n aws_secret_access_key = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\n bucket = your-bucket-name\n region = your-region (e.g. ap-northeast-1, us-east-1)\n\nYou can override these settings by specifying command line options or environment variables.\n\n* Command Line Options (will override the settings from environment variables)\n\n+--------------------------+-------------------------------------+\n| Option | Description |\n+==========================+=====================================+\n| ``--access ACCESS_KEY`` | AWS access key. |\n+--------------------------+-------------------------------------+\n| ``--secret SECRET_KEY`` | AWS secret key. |\n+--------------------------+-------------------------------------+\n| ``--bucket BUCKET_NAME`` | S3 bucket name. |\n+--------------------------+-------------------------------------+\n| ``--region REGION`` | Region name of the S3 bucket. |\n+--------------------------+-------------------------------------+\n\n* Environment Variables\n\n+---------------------------+-------------------------------------+\n| Variable Name | Description |\n+===========================+=====================================+\n| ``AWS_ACCESS_KEY_ID`` | AWS access key. |\n+---------------------------+-------------------------------------+\n| ``AWS_SECRET_ACCESS_KEY`` | AWS secret key. |\n+---------------------------+-------------------------------------+\n| ``AWS_DEFAULT_REGION`` | Region name of the S3 bucket. |\n+---------------------------+-------------------------------------+\n\n5. Check connection\n-------------------\n\nNow, you are ready for using ``art`` command in the shell. \nJust list your artifacts::\n\n $ art list GROUP_ID\n [INFO] No artifacts.\n\nOf course, there are no artifacts!\n\n6. Build the artifact\n---------------------\n\nBuilding is outside the reach of this tool. In other words, you can build as you like.\n\n7. Upload the artifact\n----------------------\n\nIn the builder's environment, you can upload the artifact to Amazon S3::\n\n $ art upload GROUP_ID /path/to/your-artifact-0.0.1.jar\n\nSpecify group id and your local file path.\n\n| Artifact ID, version and packaging(=extension) are automatically parsed from the given file name. \n| In this case, artifact ID is ``your-artifact``, version is ``0.0.1`` and packaging is ``jar``.\n\n8. View the artifact information\n--------------------------------\n\nTo view the index data, run ``art list`` or ``art info``.\n\n9. Download the artifact\n------------------------\n\nLogin to the deployer's environment, then download the artifact from Amazon S3::\n\n $ art download GROUP_ID /path/to/deployers/your-artifact-0.0.1.jar 1\n\nTo download the latest revision, use ``latest`` keyword. (case-sensitive)::\n\n $ art download GROUP_ID /path/to/deployers/your-artifact-0.0.1.jar latest\n\n10. Deploy\n----------\n\nDeploy the artifact any way you like!\n\n11. And then ...\n----------------\n\nFor further information, type ``art -h``.\n\n---------------\nAmazon S3 Paths\n---------------\n\nThe structure of the paths is the following::\n\n your-bucket-name\n \u251c\u2500\u2500 group.id.1 // group ID\n \u2502\u00a0\u00a0 \u251c\u2500\u2500 .meta // meta data directory for each group\n \u2502\u00a0 \u00a0\u2502\u00a0\u00a0 \u251c\u2500\u2500 index-awesome-project.json // index data is written as JSON for each artifact ID\n \u2502\u00a0 \u00a0\u2502\u00a0\u00a0 \u2514\u2500\u2500 index-play-project.json\n \u2502\u00a0\u00a0 \u251c\u2500\u2500 awesome-project // artifact ID\n \u2502\u00a0 \u00a0\u2502\u00a0\u00a0 \u251c\u2500\u2500 0.0.1 // version\n \u2502 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 1 // revision (auto assigned, starting from 1)\n | \u2502 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.1.jar\n | \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 2\n | \u2502 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.1.jar\n | \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u251c\u2500\u2500 3\n | \u2502 \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.1.jar\n | \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 4\n | \u2502 \u2502\u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.1.jar\n \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 0.0.2-SNAPSHOT\n \u2502 \u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 1\n | \u2502 \u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.2-SNAPSHOT.jar\n | \u2502\u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 2\n | \u2502 \u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.2-SNAPSHOT.jar\n \u2502\u00a0\u00a0 \u2514\u2500\u2500 play-project\n \u2502\u00a0 \u00a0 \u00a0 \u2514\u2500\u2500 0.0.1\n \u2502 \u00a0\u00a0 \u00a0 \u2514\u2500\u2500 1\n | \u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 play-project-0.0.1.zip\n \u2514\u2500\u2500 group.id.2\n \u00a0\u00a0 \u251c\u2500\u2500 .meta\n \u00a0 \u00a0\u2502\u00a0\u00a0 \u2514\u2500\u2500 index-awesome-project.json \n \u00a0\u00a0 \u2514\u2500\u2500 awesome-project // completely separated to the group.id.1's artifact\n \u00a0 \u00a0 \u00a0 \u2514\u2500\u2500 0.0.1\n \u00a0\u00a0 \u00a0 \u2514\u2500\u2500 1\n \u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 awesome-project-0.0.1.zip\n\n-----\nNotes\n-----\n\n* This tool supports only artifact-id-level concurrency.\n\n * Simultaneous uploading of the artifacts with same artifact id could let repository broken.\n", "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/mogproject/artifact-cli", "keywords": null, "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "artifact-cli", "package_url": "https://pypi.org/project/artifact-cli/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/artifact-cli/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/mogproject/artifact-cli" }, "release_url": "https://pypi.org/project/artifact-cli/0.1.10/", "requires_dist": null, "requires_python": null, "summary": "Private Artifact Manager using Amazon S3", "version": "0.1.10" }, "last_serial": 1724820, "releases": { "0.0.5": [ { "comment_text": "", "digests": { "md5": "6328dae3b3186b4b88dabd0b88e19e36", "sha256": "c01d74bfb6dbb93059b123fa9b0780b5909d1b216f4a877102aac71845e645fb" }, "downloads": -1, "filename": "artifact-cli-0.0.5.tar.gz", "has_sig": false, "md5_digest": "6328dae3b3186b4b88dabd0b88e19e36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10873, "upload_time": "2015-01-07T17:10:41", "url": "https://files.pythonhosted.org/packages/75/4c/5eeff6df1a7526be59a18262c3d76700a6760491cbafe68a9648502b5232/artifact-cli-0.0.5.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "134918f9399a89403e366ecaae0995ea", "sha256": "94269ff2664c082af17d46359a84b0ae6fd6a17cd5406624e02f32a43441794c" }, "downloads": -1, "filename": "artifact-cli-0.1.0.tar.gz", "has_sig": false, "md5_digest": "134918f9399a89403e366ecaae0995ea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11208, "upload_time": "2015-01-10T04:18:26", "url": "https://files.pythonhosted.org/packages/64/c5/00347211444efea8e546497806eb3251fe416bd7ce516ffd421c2c03a1a1/artifact-cli-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "3c53af185a82b31e0fe53b96e1ba2da7", "sha256": "ccb63cbd5a08d18a72b7b2914f212575dfd225803c7f79a342f339e1431afeb4" }, "downloads": -1, "filename": "artifact-cli-0.1.1.tar.gz", "has_sig": false, "md5_digest": "3c53af185a82b31e0fe53b96e1ba2da7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11247, "upload_time": "2015-01-10T04:43:42", "url": "https://files.pythonhosted.org/packages/dd/bc/a3dbd7e180f684cbd912b04f81cb628fbd6e3cf337ba2b09918281b3ff82/artifact-cli-0.1.1.tar.gz" } ], "0.1.10": [ { "comment_text": "", "digests": { "md5": "30de1b58527d8f3acd1d2ea72a8643a1", "sha256": "4ab655e902b9ed3f8c86ae9c7cd936b99848275b277d6c86fdf7db10005a578e" }, "downloads": -1, "filename": "artifact-cli-0.1.10.tar.gz", "has_sig": false, "md5_digest": "30de1b58527d8f3acd1d2ea72a8643a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14233, "upload_time": "2015-09-16T09:02:38", "url": "https://files.pythonhosted.org/packages/7c/0d/e69315612c79227ebee77d1d0c7a52cab5c6a31a8b7fe756e6a10f23fc25/artifact-cli-0.1.10.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "1d9f6cded767ed397f29ede3fe33ac34", "sha256": "bdd2a0de6e54528ba3cdd19f221144765dcc82602327c45077ea4a80ec3fb0d8" }, "downloads": -1, "filename": "artifact-cli-0.1.2.tar.gz", "has_sig": false, "md5_digest": "1d9f6cded767ed397f29ede3fe33ac34", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11271, "upload_time": "2015-01-10T05:16:01", "url": "https://files.pythonhosted.org/packages/ca/87/ec9fe2457a9a3b40078360cfa42201516deaf51ff9686595dfbce41ed1f5/artifact-cli-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "1aaf90a786a0dba5c84025ab5c81de18", "sha256": "7edf4837e89400771e8c30d7573ee45492a1754dc8ad8789e388b58dcba6a4d0" }, "downloads": -1, "filename": "artifact-cli-0.1.3.tar.gz", "has_sig": false, "md5_digest": "1aaf90a786a0dba5c84025ab5c81de18", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11308, "upload_time": "2015-01-10T15:18:59", "url": "https://files.pythonhosted.org/packages/a9/4e/3541e06fd01d28bdc6202c8dcf53d9bcb0fcf69a0e9599c4a6dc899aceb5/artifact-cli-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "7ead92fdbfc349823966f058ead167ba", "sha256": "f3b0a2fac2dad89b75bd2bf937e76e4cc68dd063321f883ac3c709167817be98" }, "downloads": -1, "filename": "artifact-cli-0.1.4.tar.gz", "has_sig": false, "md5_digest": "7ead92fdbfc349823966f058ead167ba", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13833, "upload_time": "2015-01-11T06:58:47", "url": "https://files.pythonhosted.org/packages/3f/5c/23a6abe6eafdfd94ed1b6bfb93a6f1d49de6ca8977510a69454ef95c1f1d/artifact-cli-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "7950ef282b31cc4cb245bed64f2224f2", "sha256": "1b968a2d0fce6d65199f0953d8c6ebb902fa1bb0d0ff33ece2293aee412c5172" }, "downloads": -1, "filename": "artifact-cli-0.1.5.tar.gz", "has_sig": false, "md5_digest": "7950ef282b31cc4cb245bed64f2224f2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13842, "upload_time": "2015-01-11T14:36:44", "url": "https://files.pythonhosted.org/packages/05/c1/d6c67c14f615e726bf6a80c3bae0a1f7dae8e2ac1d7ede0b2f92e1d2a7f5/artifact-cli-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "17dded06da2e0e31b1ac16c1af33402f", "sha256": "6bcd969aa446db1ef7fbeea8dfd2c8137c22f38eb5cd2fe72c15df06459d2748" }, "downloads": -1, "filename": "artifact-cli-0.1.6.tar.gz", "has_sig": false, "md5_digest": "17dded06da2e0e31b1ac16c1af33402f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13861, "upload_time": "2015-01-13T15:53:27", "url": "https://files.pythonhosted.org/packages/02/aa/a27a02b89da64bfb9e036373d8f4ce5e984537a99049baf9c17c6e97a0ba/artifact-cli-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "f3863472c1328477c1d6f83fc97e2b9a", "sha256": "63a0332467427f4a0985649954ba34266a09f0490e3fbffea86f2eeed84c44e5" }, "downloads": -1, "filename": "artifact-cli-0.1.7.tar.gz", "has_sig": false, "md5_digest": "f3863472c1328477c1d6f83fc97e2b9a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13886, "upload_time": "2015-01-14T05:00:08", "url": "https://files.pythonhosted.org/packages/a1/0b/4c56dc9742da8b3d183f3daf224244ec0d833618beafb350141980517809/artifact-cli-0.1.7.tar.gz" } ], "0.1.8": [ { "comment_text": "", "digests": { "md5": "c3c908f4387cfc1838b79da38060e3be", "sha256": "2e4f29bd06c86a7f700e9e31467b70b0b5de18c3baebc338e0deda7e2944511c" }, "downloads": -1, "filename": "artifact-cli-0.1.8.tar.gz", "has_sig": false, "md5_digest": "c3c908f4387cfc1838b79da38060e3be", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13963, "upload_time": "2015-01-14T11:27:03", "url": "https://files.pythonhosted.org/packages/48/61/6eb02e9da4c14670fc73633beb0cffb2c1689729bc0ae6130a3a48b13073/artifact-cli-0.1.8.tar.gz" } ], "0.1.9": [ { "comment_text": "", "digests": { "md5": "a939cd419de608ea51afe7c036614b73", "sha256": "64698d9b5d222d5ca2a661cc40bc32aed31a9cc5bd9f0d7547bfeecf52cda7aa" }, "downloads": -1, "filename": "artifact-cli-0.1.9.tar.gz", "has_sig": false, "md5_digest": "a939cd419de608ea51afe7c036614b73", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13820, "upload_time": "2015-01-14T12:14:29", "url": "https://files.pythonhosted.org/packages/57/62/871e81386d7b60547d3d788db5cb699679290cfbc22ad324cc9043bbada7/artifact-cli-0.1.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "30de1b58527d8f3acd1d2ea72a8643a1", "sha256": "4ab655e902b9ed3f8c86ae9c7cd936b99848275b277d6c86fdf7db10005a578e" }, "downloads": -1, "filename": "artifact-cli-0.1.10.tar.gz", "has_sig": false, "md5_digest": "30de1b58527d8f3acd1d2ea72a8643a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14233, "upload_time": "2015-09-16T09:02:38", "url": "https://files.pythonhosted.org/packages/7c/0d/e69315612c79227ebee77d1d0c7a52cab5c6a31a8b7fe756e6a10f23fc25/artifact-cli-0.1.10.tar.gz" } ] }