Metadata-Version: 2.1
Name: pypi-template
Version: 0.0.1
Summary: PyPi template repository.
Home-page: https://github.com/christophevg/pypi-template
Author: Christophe VG
License: MIT
Description: # PyPi Template
        
        > My take at a template repository that I can fork for every Python project I want to push to PyPi
        
        ![[Latest Version on PyPI](https://pypi.python.org/pypi/pypi-template/)](https://img.shields.io/pypi/v/pypi-template.svg)
        ![[Build Status](http://travis-ci.org/christophevg/pypi-template)](https://secure.travis-ci.org/christophevg/pypi-template.svg?branch=master)
        
        ## Howto, the executive summary
        
        1. fork it
        2. rename it
        3. edit it
        4. extend it
        5. use it
        
        ## Getting Started
        
        Forking and renaming are the two first steps when using this repository. They are both actions you perform at GitHub, but...
        
        ### Fork without forking...
        
        You don't have to go through the GitHub concept of forking and do everything from the command line...
        
        ```bash
        $ git clone https://github.com/christophevg/pypi-template
        $ mv pypi-template your-new-project
        $ cd your-new-project
        $ git remote remove origin
        $ git remote add origin git@github.com:your-account/your-new-project.git
        $ git push -u master origin
        ```
        
        ### Use the Command Line
        
        The repository also includes a small script that automates these steps. If you install the module, the script gets registered in your PATH, and allows for
        
        ```bash
        $ pip install pypi-template
        
        $ pypi-template my-new-project git@github.com:my-account
        Cloning into 'pypi-template'...
        remote: Enumerating objects: 53, done.
        remote: Counting objects: 100% (53/53), done.
        remote: Compressing objects: 100% (24/24), done.
        remote: Total 53 (delta 16), reused 50 (delta 13), pack-reused 0
        Unpacking objects: 100% (53/53), done.
        
        $ cd my-new-project/
        
        $ ls
        LICENSE.txt		pypi-template		tests
        MANIFEST.in		requirements.txt	tox.ini
        Makefile		setup.py
        
        $ git remote -v
        origin	git@github.com:my-account/my-new-project.git (fetch)
        origin	git@github.com:my-account/my-new-project.git (push)
        ```
        ## Things to edit
        
        1. module top-level folder
        
        There is a placeholder top-level module folder. You'll probably want to rename that.
        
        ```bash
        $ mv pypi-template your-new-project
        ```
        
        2. LICENSE.txt
        
        Change the license to whatever you feel is (more) appropriate.
        
        3. .github/README.md
        
        Replace this information with information regarding your project.
        
        4. setup.py
        
        Replace the Python package configuration with one appropriate to your project.
        
        ## Things to do
        
        ### Testing
        
        A basic testing setup has been prepared. To run it locally, issue...
        
        ```bash
        $ make test
        ...
        ___________________________________ summary ____________________________________
          py27: commands succeeded
          congratulations :)
        ```
        
        Head over to [https://travis-ci.org](https://travis-ci.org) and register you project. A basic CI setup is also provided.
        
        ### Publishing
        
        Head over to [https://test.pypi.org](https://test.pypi.org) and register for an account. Next simply issue...
        
        ```bash
        $ make publish-test
        ```
        
        to publish your module to the test instance of PyPi.
        
Keywords: pypi template
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
