{
    "info": {
        "author": "Zulko 2014",
        "author_email": "UNKNOWN",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "Picnic.py\n==========\n\nPicnic.py helps you write python packages: ::\n    \n    picnic.py new PackageName\n\nThis creates a directory with all the files you need to get started: ::\n    \n    /PackageName_project\n        /PackageName\n            /setup.py\n            /README.rst\n            /packagename\n                /__init__.py\n                /packagename.py\n\nNot enough ? Try this: ::\n\n    picnic.py new MyPackage --author=Zulko --sphinx --gitinit --dev\n\nNow you have a new package with a Sphinx documentation and a git repository for your project. And your package has been installed on your computer in *develop* mode (meaning you can change the code directly from this folder, without needing to reinstall the project).\n\nThese commands **also work on already-written packages**. For instance if I go in the ``setup.py``  folder and type ::\n    \n    picnic.py --remote=https://github.com/Zulko/MyPackage.git --ghpages\n\n\nThis will link my project to an existing Github repository and initialize the Github Pages for this project. Now I just need to push these on Github (see Cookbook below), which will give me `this repo <https://github.com/Zulko/MyPackage>`_ for the code, and `this page <http://zulko.github.io/MyPackage>`_ for the online documentation (you can change the look afterwards).\n\n\n\nInstallation and customization\n--------------------------------\n\nPicnic.py requires the awesome docopt_ package, that you can install with the classic ::\n\n    pip python install docopt \n\nTo install Picnic.py, get a zip of the code, for instance on Github_, and unzip it in some folder. You can have a look at the file templates ``README.rst``, ``setup.py`` etc in subfolder ``picnic/files``, and customize them as you like.\n\nThen, in the folder of the ``setup.py``, type ::\n\n    sudo python setup.py install\n\nor even better, use this command instead, it will enable you to change the templates even after the installation: :: \n\n    sudo python setup.py develop\n\nAnd you are done ! Note that you can also install ``picnic.py`` with ``pip`` but it is not recommended as it doesn't allow you to change the templates.\n\n\nContribute !\n------------\n\nPicnic.py is an open source software originally written by Zulko_ and released under the MIT licence. Please help make picnic better, for instance by expanding the capabilities, providing advice for sounder standards if you are an experienced module-maker, reporting bugs, etc. We love forks and pull resquests !\n\nAnd speaking about branches, there is `another one <https://github.com/jcsaaddupuy/picnic.py/tree/dev>`_ being actively developed.\n\nPicnic is being developped on Github_. That's where you should go for troubleshooting and bug reports.\n\n\n\n\nCookbook  \n---------\n\nIn this section, which is meant for beginners in Python, Sphinx, git, and Github, we explain how the files created by Picnic.py are meant to be used. You can also get help from the console with ::\n\n    picnic.py --help\n\n\nCreating a Python package\n''''''''''''''''''''''''''''\n\nTo start a new project, you type ::\n\n    picnic.py new PackageName\n\nTo install the package (you will be able to modify the code afterwards) type ::\n    \n    python setup.py develop\n\nor equivalently ::\n    \n    picnic.py --dev\n    \nNow we can start to code: we go in directory ``PackageName/packagename`` and in the file ``packagename.py`` we write ::\n\n    def say_hello():\n        print \"Hello world !\"\n    \nTo check that this worked, open a python console (in any folder) and type ::\n    \n    >>> import packagename\n    >>> packagename.say_hello()\n     Hello World !\n\n\n\nCreating a Sphinx documentation\n'''''''''''''''''''''''''''''''''\n\nTo initialize the Sphinx_ documentation you type ::\n    \n    picnic.py [new PackageName] --author=\"Your Name\" --sphinx\n\nThe documentation source will be in the ``docs`` directory and the built (html) doc will be in the folder ``built_docs/html/``. To preview the docs after you have made some changes you can go into the ``docs`` repository and type ::\n\n    make html\n    firefox ../../built_docs/html/index.html\n\nFor convenience these two lines are already written in the ``docs/make_html.sh`` file, therefore you only need to type ::\n    \n    ./make_html.sh\n\n\nCreating a git repository\n''''''''''''''''''''''''''''''''''\n\nTo create a git repository the classic way, you generally add a  ``.gitignore`` file to your folder (to specify what kind of files not to include in the repo) and type these lines ::\n    \n    git init\n    git add .\n    git commit -m \"Initial commit\"\n    \nThe ``--git`` option does exactly all this: it adds a .gitignore file to the folder and runs all these commands. Be sure to run it in the directory where your ``setup.py`` is.\n\nLinking to a repository on Github\n''''''''''''''''''''''''''''''''''\n\n\nTo put this git repository on a Github, first create a repo on Github (say no when they ask you whether to include a README file). Github should give you the url of the repo, something like ``https://github.com/Zulko/MyPackage.git``. Then in a console type ::\n\n    git add remote origin https://github.com/Zulko/MyPackage.git\n\nor equivalently ::\n\n    picnic.py --remote=https://github.com/Zulko/MyPackage.git\n\nTo commit the changes to the git repo I generally do ::\n    \n    git commit -a -m \"my description of the commit\"\n    \nAnd after this, to push the changes on the online Github repo:\n\n    git push origin master\n\n\nCreating Github-pages\n'''''''''''''''''''''''\n\nHere we suppose that you have already linked your project to Github with ::\n\n    git add remote origin https://link/to/your/repo.git\n    \nor equivalently ::\n\n    picnic.py --remote=https://link/to/your/repo.git\n\nNow all you have to do is ::\n    \n    picnic.py --ghpages\n\nThis creates a special git repository for the Github Pages in the directory ``built_docs/html``, which is the output directory of the documentation.\n\nWhen you are happy with the way your documentation looks you go into folder ``built_docs/html`` and type ::\n\n    git commit -a -m \"my description of the commit\"\n    git push origin gh-pages\n\nThat's all there is to know !\n\n\n.. _Zulko : https://github.com/Zulko\n.. _Github : https://github.com/Zulko/picnic.py\n.. _Sphinx : http://sphinx-doc.org/\n.. _docopt: http://docopt.org/",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "UNKNOWN",
        "keywords": "python module package template engine setuptools",
        "license": "see LICENSE.txt",
        "maintainer": null,
        "maintainer_email": null,
        "name": "picnic",
        "package_url": "https://pypi.org/project/picnic/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/picnic/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "UNKNOWN"
        },
        "release_url": "https://pypi.org/project/picnic/0.0.0.5/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Python packages creation made easy",
        "version": "0.0.0.5"
    },
    "last_serial": 974983,
    "releases": {
        "0.0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8a48d5c76dfb9dd4b699b96192ef0860",
                    "sha256": "9e317cd5f06ba7c424dd5429997f001fc26747d5e006d815f582ad0ce546fcaa"
                },
                "downloads": -1,
                "filename": "picnic-0.0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "8a48d5c76dfb9dd4b699b96192ef0860",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6658,
                "upload_time": "2014-01-11T16:34:46",
                "url": "https://files.pythonhosted.org/packages/23/c6/790fcc40e26a10a58452aa8dff7a272e0f6ea84d50f9d0dcd9ff295738e7/picnic-0.0.0.1.tar.gz"
            }
        ],
        "0.0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "282f3ffba99af238bcfecb7e8b7d78f2",
                    "sha256": "9e89299a7ede1e2f70815c820e4dc2fb472240512644f5fc1aceb29f7ad7463b"
                },
                "downloads": -1,
                "filename": "picnic-0.0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "282f3ffba99af238bcfecb7e8b7d78f2",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6629,
                "upload_time": "2014-01-11T16:37:59",
                "url": "https://files.pythonhosted.org/packages/05/68/2025c57d0b1415e0cec1efe3dab407958ce86562f09b09cd3c089813ca38/picnic-0.0.0.2.tar.gz"
            }
        ],
        "0.0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "35d84576074e163378912e9418b395ba",
                    "sha256": "34b584b2c1293b902a9aec9cb5e0cb3662f81cf2ae288a411312a867ab374f0a"
                },
                "downloads": -1,
                "filename": "picnic-0.0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "35d84576074e163378912e9418b395ba",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 9438,
                "upload_time": "2014-01-16T22:55:57",
                "url": "https://files.pythonhosted.org/packages/06/ae/01916fe3b94eb493b76d9140da16dc2e80ea537cfc87db992094b85d7c49/picnic-0.0.0.3.tar.gz"
            }
        ],
        "0.0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fdea832a2c73344ec97b50316c7e6a8e",
                    "sha256": "ba992f23788e98dbc70b728b75ce011d1f7addc6e930a2cb453e703614683f17"
                },
                "downloads": -1,
                "filename": "picnic-0.0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "fdea832a2c73344ec97b50316c7e6a8e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 9515,
                "upload_time": "2014-01-17T11:52:27",
                "url": "https://files.pythonhosted.org/packages/90/f9/c70c5ddaff1b925ec910735ddf0b1f70a97d5dc8b13e0d5cd872afca3f38/picnic-0.0.0.4.tar.gz"
            }
        ],
        "0.0.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e8fb624b1b48b2c12f8867082690e1e4",
                    "sha256": "d351aac4ba5c8a41cb5297c07c02182b7e80e5160b195f72db8cbb7c84bb2b0a"
                },
                "downloads": -1,
                "filename": "picnic-0.0.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "e8fb624b1b48b2c12f8867082690e1e4",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6940,
                "upload_time": "2014-01-20T19:06:27",
                "url": "https://files.pythonhosted.org/packages/e8/f4/998e90b88264f30545eb266d58a218616d3dbb3c3a6b791813f31f36febf/picnic-0.0.0.5.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "e8fb624b1b48b2c12f8867082690e1e4",
                "sha256": "d351aac4ba5c8a41cb5297c07c02182b7e80e5160b195f72db8cbb7c84bb2b0a"
            },
            "downloads": -1,
            "filename": "picnic-0.0.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "e8fb624b1b48b2c12f8867082690e1e4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6940,
            "upload_time": "2014-01-20T19:06:27",
            "url": "https://files.pythonhosted.org/packages/e8/f4/998e90b88264f30545eb266d58a218616d3dbb3c3a6b791813f31f36febf/picnic-0.0.0.5.tar.gz"
        }
    ]
}