Metadata-Version: 2.0
Name: pkglts
Version: 1.2.0
Summary: Building packages with long term support
Home-page: https://github.com/revesansparole/pkglts
Author: revesansparole, 
Author-email: revesansparole@gmail.com, 
License: CeCILL-C
Keywords: packaging,package builder
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6

======
pkglts
======

.. {# pkglts, doc


.. image:: https://readthedocs.org/projects/pkglts/badge/?version=latest
    :alt: Documentation status
    :target: https://pkglts.readthedocs.io/en/latest/?badge=latest


.. image:: https://travis-ci.org/revesansparole/pkglts.svg?branch=master
    :alt: Travis build status
    :target: https://travis-ci.org/revesansparole/pkglts


.. image:: https://coveralls.io/repos/github/revesansparole/pkglts/badge.svg?branch=master
    :alt: Coverage report status
    :target: https://coveralls.io/github/revesansparole/pkglts?branch=master


.. image:: https://landscape.io/github/revesansparole/pkglts/master/landscape.svg?style=flat
    :alt: Code health status
    :target: https://landscape.io/github/revesansparole/pkglts/master


.. image:: https://badge.fury.io/py/pkglts.svg
    :alt: PyPI version
    :target: https://badge.fury.io/py/pkglts

.. #}

Building packages with long term support


.. image:: https://raw.githubusercontent.com/revesansparole/pkglts/master/avatar.png
    :align: right
    :width: 256px

The rationale behind the creation of this 'package builder' is to keep the life
of a python programmer as easy as possible by providing three core functions:

 - A way to add more functionality to an existing package.
 - A way to keep the package structure up to date with currently known best
   practices.
 - Remove repetitive tasks that can be automated from the list of things to do.

.. _Python: http://python.org

Quick start
===========

Create a virtual environment for development::

    $ virtualenv dvlpt

Activate it::

    $ (on windows)dvlpt\Scripts\activate
    $ (on linux)dvlpt/bin/activate

Install pkglts_::

    (dvlpt)$ pip install pkglts

Create a directory for your package::

    (dvlpt)$ mkdir toto

Run 'manage' inside this directory::

    (dvlpt)$ cd toto
    (dvlpt)toto$ pmg init
    (dvlpt)toto$ pmg add base
    (dvlpt)toto$ pmg regenerate

This will create the bare basic minimum for a python package. Add more options
(see the add_option_ for more options) afterward. Especially, since in the example
above we just added the 'base' option that will create a 'src' directory to put
your code in it.

.. _pkglts: https://pypi.python.org/pypi/pkglts/
.. _add_option: https://pkglts.readthedocs.org/en/latest/option_list.html

Documentation
=============

More documentation can be found on readthedocs_pkglts_. If you just intend to use this package
you can start with some tutorials_. However, if the core functionality are
not sufficient and you want to be part of the development you might be interested
with the developer_ section of the doc.


.. _readthedocs_pkglts: https://pkglts.readthedocs.org/en/latest
.. _tutorials: https://pkglts.readthedocs.org/en/latest/tutorials.html
.. _developer: https://pkglts.readthedocs.org/en/latest




History
-------

creation (TODAY)
------------------------

* First release on PyPI.


