{ "info": { "author": "Chris Jerdonek", "author_email": "chris.jerdonek@gmail.com", "bugtrack_url": null, "classifiers": [], "description": ".. This file is auto-generated by setup.py for PyPI using pandoc, so this\n.. file should not be edited. Edits should go in the source files.\n\nMolt\n====\n\n.. figure:: https://github.com/cjerdonek/molt/raw/master/images/molt.png\n :align: center\n :alt: molting snake\n\n`Molt `_ is a script to stub out\nprojects in any language instantly using\n`Mustache `_-based project templates.\n\nYou can use Molt to decrease the amount of boilerplate code you need to\nwrite when starting new projects: the README, copyright notices, license\ninfo, logging configuration, option parsing, test harness, packaging\ninformation, ``.gitignore``, directory hierarchy, etc.\n\nA minimal sample usage looks like--\n\n::\n\n $ molt -c path_to_config.json path_to_template_dir/\n\nMolt follows the `Groome `_ rules\nfor Mustache-based project templates. See the\n`Groome `_ page for project\ntemplate syntax. This version of Molt follows `version\n0.1.0 `_ of Groome.\n\nMolt is written in `Python `_ and can be found\non `GitHub `_ and on\n`PyPI `_ (the Python Package Index).\n\nFeedback is welcome. You can also file bug reports and feature requests\non the GitHub `issues page `_.\n\nRequirements\n------------\n\nMolt supports the following Python versions:\n\n- Python 2.7\n- Python 3.2\n- `PyPy `_\n\nPython 3.x support is coming soon. Since Molt is a development tool,\nthere are no plans to support Python 2.6 or earlier.\n\nMolt's dependencies are--\n\n- `Pystache `_ version\n `0.5.2 `_ or above\n- `PyYAML `_ (optional, to support\n YAML format for configuration files)\n\nThe installation process below installs these dependencies\nautomatically.\n\nYou can install to Python 2 with either\n`setuptools `_ or\n`Distribute `_ (preferred). For\nPython 3, you must use Distribute.\n\nInstall It\n----------\n\n::\n\n $ pip install molt\n\nTest it\n-------\n\n::\n\n $ molt --run-tests\n\nTry it\n------\n\nStart with the\n`demo `_ Groome\ntemplate to play with:\n\n::\n\n $ molt --create-demo --output demo\n $ ls -p demo\n expected/ lambdas/ partials/ sample.json structure/\n\nRender the template with the sample context provided:\n\n::\n\n $ molt --output output --config demo/sample.json demo\n\nRun the newly-created project (which can also be seen\n`here `_)):\n\n::\n\n $ python output/hello.py world\n Hello, world!\n\nFor help documentation and available options--\n\n::\n\n $ molt -h\n\nNote the ``--visualize`` and ``--with-visualize`` options that let you\nquickly visualize entire directory contents.\n\n::\n\n $ molt --visualize output\n\nIf using Python, you can also use Molt as a library (though the API is\nnot yet stable). See the ``Molter`` class in the\n`molt.molter `_\nmodule.\n\nContribute\n----------\n\nIf using GitHub, after forking--\n\n::\n\n $ git clone git@github.com:yourusername/molt.git\n $ cd molt\n $ git remote add upstream git://github.com/cjerdonek/molt.git\n $ git fetch upstream\n\nTo run unit tests--\n\n::\n\n $ python test_molt.py\n\nTo test Molt with multiple versions of Python (with a single command!),\nyou can use `tox `_:\n\n::\n\n pip install tox\n tox\n\nIf you don't have all Python versions listed in ``tox.ini``, you can\ndo--\n\n::\n\n tox -e py27 # for example\n\nTo run from source any molt command of the form--\n\n::\n\n $ molt [options] [DIRECTORY]\n\nsimply type--\n\n::\n\n $ python -m molt.commands.molt [options] [DIRECTORY]\n\nTo include the `Groome\ntests `_ in your\ntest runs, initialize and update the Groome project submodule--\n\n::\n\n $ git submodule init\n $ git submodule update\n\nTo run a subset of the tests, you can filter your test runs using one or\nmore prefixes. For example--\n\n::\n\n $ python test_molt.py molt.test.common molt.test.dir\n\nMolt is also `set\nup `_ on\nGitHub to work with `Travis CI `_.\n\nPython 3 Tips\n~~~~~~~~~~~~~\n\nMolt is written in Python 2, so the code must be converted to Python 3\nprior to using with Python 3. The installation process does this\nautomatically.\n\nTo convert the code to Python 3 manually, run the following using Python\n3 (with Distribute installed)--\n\n::\n\n python setup.py build\n\nThis writes the converted code to a subdirectory of the project\ndirectory called ``build``.\n\nIt is possible (though not recommended) to convert the code without\nusing ``setup.py``. You can try this with\n`2to3 `_, as follows (two\nsteps):\n\n::\n\n 2to3 --write --nobackups --no-diffs --doctests_only molt\n 2to3 --write --nobackups --no-diffs molt\n\nThis converts the code (and doctests) in place.\n\nTo ``import molt`` from a source distribution while using Python 3, be\nsure that you are importing from a directory containing the converted\ncode (e.g. from the ``build`` directory after converting), and not from\nthe original (unconverted) source directory. Otherwise, you will get a\nsyntax error. You can help prevent this by not running the Python IDE\nfrom the project directory when importing Molt while using Python 3.\n\nAuthor\n------\n\nMolt is authored by `Chris Jerdonek `_.\nChris is also the author of\n`Groome `_ and is the current\n`Pystache `_ maintainer.\n\nCopyright\n---------\n\nCopyright (C) 2011-2012 Chris Jerdonek. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n- Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n- Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n- The names of the copyright holders may not be used to endorse or\n promote products derived from this software without specific prior\n written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS\nIS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\nTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nHOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED\nTO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\nHistory\n=======\n\n0.1.1 (2012-07-01)\n------------------\n\n- Add Python 3 support.\n\n0.1.0 (2012-06-30)\n------------------\n\n- Initial release (for Python 2.7 and PyPy).", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://cjerdonek.github.com/molt/", "keywords": "project template mustache pystache groome", "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "molt", "package_url": "https://pypi.org/project/molt/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/molt/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://cjerdonek.github.com/molt/" }, "release_url": "https://pypi.org/project/molt/0.1.1/", "requires_dist": null, "requires_python": null, "summary": "Mustache project templates using Python and Groome", "version": "0.1.1" }, "last_serial": 794919, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "d52e0e12bbff6d2841c70999217ac748", "sha256": "60403c7ba3fbb97af50d0c52a947e6a88e1115b4677ff1903fd2d8e99cafb3a7" }, "downloads": -1, "filename": "molt-0.1.0.tar.gz", "has_sig": false, "md5_digest": "d52e0e12bbff6d2841c70999217ac748", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 66446, "upload_time": "2012-07-01T02:14:56", "url": "https://files.pythonhosted.org/packages/2a/c7/81b21ff0764adb1fc2f908c77d5f514c4d01d7427ce5d395dc12bcc8a7ab/molt-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "87d4d42810a9f3b16ef49d9e4f2b3930", "sha256": "965fceb17e3d9002ceab44bb284ea6696db574db74ad8734b7cc79e53237cf44" }, "downloads": -1, "filename": "molt-0.1.1.tar.gz", "has_sig": false, "md5_digest": "87d4d42810a9f3b16ef49d9e4f2b3930", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 68696, "upload_time": "2012-07-01T18:46:22", "url": "https://files.pythonhosted.org/packages/c1/97/0dc7c105151e93d490156f0351d499d955f0e18c53b5c627ad84d785e817/molt-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "87d4d42810a9f3b16ef49d9e4f2b3930", "sha256": "965fceb17e3d9002ceab44bb284ea6696db574db74ad8734b7cc79e53237cf44" }, "downloads": -1, "filename": "molt-0.1.1.tar.gz", "has_sig": false, "md5_digest": "87d4d42810a9f3b16ef49d9e4f2b3930", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 68696, "upload_time": "2012-07-01T18:46:22", "url": "https://files.pythonhosted.org/packages/c1/97/0dc7c105151e93d490156f0351d499d955f0e18c53b5c627ad84d785e817/molt-0.1.1.tar.gz" } ] }