{ "info": { "author": "Tjelvar Olsson", "author_email": "tjelvar.olsson@jic.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7" ], "description": "========\njicagile\n========\n\n- GitHub: https://github.com/JIC-CSB/jicagile\n- PyPI: https://pypi.python.org/pypi/jicagile\n- Free software: MIT License\n\nInstallation\n------------\n\nTo install the jicagile package.\n\n.. code-block:: bash\n\n pip install jicagile\n\nOr install it from source.\n\n.. code-block:: bash\n\n git clone https://github.com/JIC-CSB/jicagile.git\n cd jicagile\n python setup.py install\n\n\nUsage\n-----\n\nThe package comes with a command line utility named ``agl``.\nWhen you run the ``agl`` command it assumes that you are in\na directory where you want to store your agile project management\nfiles.\n\nThe ``agl`` tool comes with built-in Git integration. To enable\nthis simply initialise the project directory as a git repository.\n\n.. code-block:: bash\n\n git init\n\nThe step above is optional, but highly recommended. Git is great.\n\nNow let's illustrate how to add a task to our agile project.\nThe command below creates a task with the title\n``\"Learn how to use agl cmd line\"`` of size 3. The available\nstory point sizes are 1, 3, 5 and 8.\n\n.. code-block:: bash\n\n agl add \"Learn how to use agl cmd line\" 3\n\nThis will create a ``backlog`` directory and place a file named\n``learn-how-to-use-agl-cmd-line.yml`` file in it. It will also\ncreate the directories ``current/{todo,done}``.\n\nTo move the task to the current sprint.\n\n.. code-block:: bash\n\n agl mv backlog/learn-how-to-use-agl-cmd-line.yml current/todo\n\nTo mark the task as done.\n\n.. code-block:: bash\n\n agl mv current/todo/learn-how-to-use-agl-cmd-line.yml current/done\n\nTo add a task to the current \"todo\" list one can use the ``-c`` argument\n(mnemonic current).\n\n.. code-block:: bash\n\n agl add -c \"Email friends about jicagile\" 1\n\nTo list the content of the backlog.\n\n.. code-block:: bash\n\n agl list backlog/\n\nThe ``todo`` and ``done`` directories have aliases so you do not need to\nspecify the full path to list their content.\n\n.. code-block:: bash\n\n agl list todo\n agl list done\n\nYou can edit tasks using your favorite text editor or you can use the\n``agl edit`` command. For example the command below increases the number\nof story points from one to five.\n\n.. code-block:: bash\n\n agl edit current/todo/email-friends-about-jicagile.yml --storypoints=5\n\nYou can add themes to your project.\n\n.. code-block:: bash\n\n agl theme add admin \"Emails, forms, meetings, etc\"\n agl edit current/todo/email-friends-about-jicagile.yml --theme=admin\n\nThemes are stored in a ``.themes.yml`` file.\n\nIt is also possible to add team members to your project.\n\n.. code-block:: bash\n\n agl teammember add TO Tjelvar Olsson\n agl teammember add MH Matthew Hartley\n\nTeam members are stored in a ``.team.yml`` file.\n\nYou can then associate a task with a primary contact.\n\n.. code-block:: bash\n\n agl add \"Write report\" 8 -p MH -e admin\n\nIn the above ``-p`` is the short hand for ``--primary-contact`` and\n``-e`` is short hand for ``--theme``.\n\nNote that the ``agl`` tool simply creates text files. It can be therefore be\nused together with ``git``. In fact all of the commands above automatically\nhave Git integration built-in. It can be very satisfying to have the agile\nproject management files under version control on GitHub.\n\nOnce you have had your sprint review meeting and all the relevant\nfiles have been moved to the ``current/done`` directory create a\ndirectory named ``past_sprints``.\n\n.. code-block:: bash\n\n mkdir past_sprints\n\nThen move and rename the ``current/done`` directory there with\ntodays date using a year-month-day scheme.\n\n.. code-block:: bash\n\n agl mv current/todo past_sprints/2016-06-19\n\n\nRelease notes\n-------------\n\n0.4.0\n~~~~~\n\n- *Added Git integration*\n- Added ``agl mv`` command\n- Fixed defect where adding to an empty config file caused and iteration error\n\n0.3.0\n~~~~~\n\n- Added ability to add and remove team members from the command line\n- Updated the format of the output from the ``agl list`` command\n\n0.2.0\n~~~~~\n\n- Refactored and redesigned the command line interface\n- Improved test coverage\n- Added color to list output\n- Added ability to associate a task with a theme", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/JIC-CSB/jicagile/tarball/0.4.0", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/JIC-CSB/jicagile", "keywords": "agile,project,management", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "jicagile", "package_url": "https://pypi.org/project/jicagile/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/jicagile/", "project_urls": { "Download": "https://github.com/JIC-CSB/jicagile/tarball/0.4.0", "Homepage": "https://github.com/JIC-CSB/jicagile" }, "release_url": "https://pypi.org/project/jicagile/0.4.0/", "requires_dist": null, "requires_python": null, "summary": "Lighweight command line tool for agile project management", "version": "0.4.0" }, "last_serial": 2184222, "releases": { "0.2.0": [ { "comment_text": "", "digests": { "md5": "87cde0994433c27a1ad1299a75d2a8ca", "sha256": "f2714fb1e2c004cca0f3d8edbd7696a7f9fde1e9d025bdd9447097e38673de5b" }, "downloads": -1, "filename": "jicagile-0.2.0.tar.gz", "has_sig": false, "md5_digest": "87cde0994433c27a1ad1299a75d2a8ca", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7539, "upload_time": "2016-06-19T11:44:53", "url": "https://files.pythonhosted.org/packages/fd/70/7741c103733a79c208747b08a285a33212a2010ea27d5c5ee7c4e68e2800/jicagile-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "3e2b65778251a5922cf8486760ced22a", "sha256": "3dfb82a7de734dd997e95123baacac146efc36c07efdbc3df27a08550946c28f" }, "downloads": -1, "filename": "jicagile-0.2.1.tar.gz", "has_sig": false, "md5_digest": "3e2b65778251a5922cf8486760ced22a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7816, "upload_time": "2016-06-19T12:26:25", "url": "https://files.pythonhosted.org/packages/d1/38/40b374d489c36a5863ad503a707733ed3e9323c06a7ba30e596d69f6e15f/jicagile-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "4614005a63f56519ee3af23f1932b0c2", "sha256": "3d310ca0dfee1fadbcdc33c67c77b054156dae2101e850b2b21a88f14eba942d" }, "downloads": -1, "filename": "jicagile-0.2.2.tar.gz", "has_sig": false, "md5_digest": "4614005a63f56519ee3af23f1932b0c2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7832, "upload_time": "2016-06-19T12:34:32", "url": "https://files.pythonhosted.org/packages/84/e5/eb9e34160e4df2b936f48b6e8bfed3ebd564fa5cec43735274e427d67fb0/jicagile-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "06d55efcf7e54525120716a9f800b1b0", "sha256": "dc1acb19cb3935dc90a3dc1101323c104fe1a0675b77ee15b97089d02cf075ab" }, "downloads": -1, "filename": "jicagile-0.2.3.tar.gz", "has_sig": false, "md5_digest": "06d55efcf7e54525120716a9f800b1b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7821, "upload_time": "2016-06-19T12:45:15", "url": "https://files.pythonhosted.org/packages/f3/f5/72366afa5c947fdeef9285f69ae929d17c627b725c5a8eb9766252fae838/jicagile-0.2.3.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "145b91f642d0c09ce2cfd23bda9f1941", "sha256": "c955655a885653c80157e578639baffa8506be8ba57b5598f223c3db3b4a95ca" }, "downloads": -1, "filename": "jicagile-0.3.0.tar.gz", "has_sig": false, "md5_digest": "145b91f642d0c09ce2cfd23bda9f1941", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8130, "upload_time": "2016-06-21T21:29:32", "url": "https://files.pythonhosted.org/packages/2a/5d/c8e4f64962d211689415f50c44a9d8f3b4fc93c308c402d34f9b6ca709e3/jicagile-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "9a40eaa7eb2f24a27d30135a0b80786c", "sha256": "7069a921f00296c43237231c2a5b719281f976107dd3140a3e8c6392a2095afe" }, "downloads": -1, "filename": "jicagile-0.4.0.tar.gz", "has_sig": false, "md5_digest": "9a40eaa7eb2f24a27d30135a0b80786c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8804, "upload_time": "2016-06-23T22:09:43", "url": "https://files.pythonhosted.org/packages/7b/cb/0f7901710abae959e23e0c4af11c1f7d1e674a230d8441a5c3cf8b962099/jicagile-0.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9a40eaa7eb2f24a27d30135a0b80786c", "sha256": "7069a921f00296c43237231c2a5b719281f976107dd3140a3e8c6392a2095afe" }, "downloads": -1, "filename": "jicagile-0.4.0.tar.gz", "has_sig": false, "md5_digest": "9a40eaa7eb2f24a27d30135a0b80786c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8804, "upload_time": "2016-06-23T22:09:43", "url": "https://files.pythonhosted.org/packages/7b/cb/0f7901710abae959e23e0c4af11c1f7d1e674a230d8441a5c3cf8b962099/jicagile-0.4.0.tar.gz" } ] }