{ "info": { "author": "Mike Lowen", "author_email": "mike@mlowen.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3.3", "Topic :: Software Development :: Libraries :: Application Frameworks" ], "description": "|BuildStatus|_\r\n\r\n.. |BuildStatus| image:: https://travis-ci.org/mlowen/Glint.png?branch=master\r\n.. _BuildStatus: https://travis-ci.org/mlowen/Glint\r\n\r\nGlint is a micro framework for command line applications, it creates the needed parameters that should be passed to the application \r\nbased on the function signatures that it is supplied.\r\n\r\nInspiration\r\n===========\r\n\r\nThe inspiration for Glint came from wanting to have a command driven cli app similar to how git works which I was unable to replicate \r\nwith `argparse `_.\r\n\r\nRequirements\r\n============\r\n\r\nGlint requires Python 3.3 or higher to run, it has no other dependencies outside of the python core library.\r\n\r\nInstallation\r\n============\r\n\r\nThe easiest way to install Glint is to use `pip `_ and run: ::\r\n\r\n\tpip install glint\r\n\r\nOtherwise download the Glint source code extract it and from the root directory run: ::\r\n\r\n\tpython ./setup.py install\r\n\r\nUsage\r\n=====\r\n\r\nAll usage documentation for Glint can be found over at `read the docs `_. \r\n\r\nFuture Plans\r\n============\r\n\r\nIf you want to see what's coming up in the near future for Glint go visit the `huboard `_ for \r\nthe project.\r\n\r\nContributing\r\n============\r\n\r\nThe source for Glint can be found over at `Github `_, if you want to contribute that would be a good \r\nplace to start. If you are wanting to report a bug all of that is kept at github as well in the `issue tracker `_, \r\nthe issues are also used to track upcoming work on Glint though features/issues that will be worked on before the next release can be more \r\neasily visualised over at `huboard `_. If you want to keep a track of the status of the bleeding edge \r\nthen you'll able to see the current state at `Travis `_.\r\n\r\nSubmitting changes\r\n------------------\r\n\r\nYou've downloaded/cloned Glint and made some changes you'd like to have merged in, firstly awesome thanks hugely! There are a couple of guidelines \r\naround submitting changes:\r\n\r\n* Changes will only be accepted via pull requests on github.\r\n* Any code changes should have some unit tests, if it's a fix for a bug it won't be accepted unless it has tests.\r\n* Again with any code changes if your pull request `breaks the build `_ it won't be accepted.\r\n\r\nRunning the tests\r\n-----------------\r\n\r\nWhile Glint doesn't have any dependencies outside of the python core library you will need to install `nose `_ to \r\nrun the tests. Once that is installed you have two options for running the test you can run either: ::\r\n\r\n\tnostests\r\n \r\nor ::\r\n\r\n\tpython ./setup.py test\r\n\r\nChange Log\r\n==========\r\n\r\nv0.2.0\r\n------\r\n\r\n* Updated the argument parsing to allow optional arguments in the format of =\r\n* Updated the argument parsing to replace - characters with _ when parsing positional arguments and flags.\r\n\r\nv0.1.0\r\n------\r\n\r\n* Running a method based on the first argument supplied.\r\n* Running a 'default' method when no arguments are supplied.\r\n* Parsing of positional arguments based on method signature.\r\n* Parsing of optional arguments based on method signature.\r\n* Parsing of flags based on method signature.\r\n* Printing of dynamically generated help screen based on the commands that had been set up.\r\n* Printing of dynamically generated help screen for a particular command based on the method signature supplied to that command.\r\n\r\nLicense\r\n=======\r\n\r\nGlint is available under the MIT license which is as follows:\r\n\r\nCopyright \u00a9 2013 Michael Lowen\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.", "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/mlowen/Glint", "keywords": "cli argument parser command line", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "Glint", "package_url": "https://pypi.org/project/Glint/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/Glint/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/mlowen/Glint" }, "release_url": "https://pypi.org/project/Glint/0.2.0/", "requires_dist": null, "requires_python": null, "summary": "Command line application micro-framework.", "version": "0.2.0" }, "last_serial": 883887, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "ef351e16a089324e2749153f178408f4", "sha256": "7c31125ea51b58d0429efa38966efcf11db1531179832f6c203451db0b4a197b" }, "downloads": -1, "filename": "Glint-0.1.0.zip", "has_sig": false, "md5_digest": "ef351e16a089324e2749153f178408f4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9420, "upload_time": "2013-07-29T06:47:18", "url": "https://files.pythonhosted.org/packages/35/f3/cc841ae8bc5af433dc6ec8cfa3f88f1fcef548297f144bb21a1d42d1d67f/Glint-0.1.0.zip" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "5166482e078a344fe7d43adc4e9d4b36", "sha256": "d249e5606231af9612c71158ae8e3a7ca0933d3a6cb597096d61338f1aa3a0a2" }, "downloads": -1, "filename": "Glint-0.2.0.zip", "has_sig": false, "md5_digest": "5166482e078a344fe7d43adc4e9d4b36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9984, "upload_time": "2013-10-08T08:27:20", "url": "https://files.pythonhosted.org/packages/1e/58/286b5ce2a301d654f07a475d86e85ea1897df3c0347637038de52e31027b/Glint-0.2.0.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5166482e078a344fe7d43adc4e9d4b36", "sha256": "d249e5606231af9612c71158ae8e3a7ca0933d3a6cb597096d61338f1aa3a0a2" }, "downloads": -1, "filename": "Glint-0.2.0.zip", "has_sig": false, "md5_digest": "5166482e078a344fe7d43adc4e9d4b36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9984, "upload_time": "2013-10-08T08:27:20", "url": "https://files.pythonhosted.org/packages/1e/58/286b5ce2a301d654f07a475d86e85ea1897df3c0347637038de52e31027b/Glint-0.2.0.zip" } ] }