mkpip 0.9.4

mkpip

mkpip
=====

Boilerplate python packaging

Tools
-----

:mkpip: Creates boilerplate python module
:mkbin: Creates a boilerplate script with argparse args, options and flags
:bumpy: Bumps the version in all recursive files in a python module (``__version__`` stuff)

mkpip
-----
usage: mkpip [-h] [--keywords KEYWORDS] [--dest DEST] [--config CONFIG]
[--author AUTHOR] [--email EMAIL] [--year YEAR]
[--copyright-holder COPYRIGHT_HOLDER]
[--license-path LICENSE_PATH] [--license LICENSE] [--url URL]
name desc

positional arguments:
name Name of project.
desc Description of project. Will go in README.rst,
setup.py, and license

optional arguments:
-h, --help show this help message and exit
--keywords KEYWORDS, -k KEYWORDS
keywords in setup.py
--dest DEST, -d DEST Destination directory that contains project folder
(default ./$name)
--config CONFIG, -c CONFIG
Name of config key in ~/.mkpip.cfg
--author AUTHOR, -a AUTHOR
Author
--email EMAIL, -e EMAIL
Author's email
--year YEAR, -y YEAR copyright year
--copyright-holder COPYRIGHT_HOLDER, -C COPYRIGHT_HOLDER
copyright holder
--license-path LICENSE_PATH, --lp LICENSE_PATH
custom license template path
--license LICENSE, -l LICENSE
license in setup.py
--url URL, -r URL url pattern for project's repo

mkbin
-----

usage: mkbin [-h] [--flags FLAGS] [--pos POS] [--opts OPTS] [--output OUTPUT]
[--boto] [--collections] [--flask] [--mysqldb] [--psycopg2]
[--requests] [--standard] [--subprocess] [--yamlcfg]

optional arguments:
-h, --help show this help message and exit
--flags FLAGS, -F FLAGS
name of flags
--pos POS, -P POS name of positionals
--opts OPTS, -O OPTS name of optionals
--output OUTPUT, --out OUTPUT, -o OUTPUT
output script path
--boto, -b add boto connection import statements
--collections, --coll, -c
add collections, namedtuple and defaultdict
--flask, --fl, -f add flask import and boilerplate
--mysqldb, --mysql, -m
add mysqldb import
--psycopg2, --psql, -p
add psycopg2 imports
--requests, --req, -r
add requests import statement
--standard, --std, -s
add os,sys imports
--subprocess, --sub, -S
add subprocess imports
--yamlcfg, --ycfg, -y
add yamlcfg imports

bumpy
-----

usage: bumpy [-h] [--check] [--major] [--minor] [--patch] [--set SET]
[--root-dir ROOT_DIR] [--push] [--quiet] [--dry]

optional arguments:
-h, --help show this help message and exit
--check, -c print current version
--major, -M bump major
--minor, -m bump minor
--patch, -p bump patch level
--set SET, -s SET set version number
--root-dir ROOT_DIR, -r ROOT_DIR
path to root directory with files with versions
--push, -P tag and push using git
--quiet, -q
--dry, -d

releases
--------

:0.9.3: fix MANIFEST
:0.9.2: Changed config to be solely ``~/.mkpip.cfg`` and allow you to specify values under [default] and [other], then -c other uses that.
:0.9.1: Add ``--include-paths``/``-i`` option to restrict to few files
:0.9.0: Fixed bumpy to find all ``__version__`` stuff as well when bumping
:0.8.3: Fixed .gitignore template
:0.8.2: Added stuff like ``__title__`` and ``__author__`` to the ``__init__.py``
:0.8.1: Deleted extra whitespace in ``__init__.py``
:0.8.0: - Refactored mkpip with some major improvements
- checks configs from .py, .yml and .cfg
- uses {format} notation instead of %(this)s
- added tox files for easy test generation