README.md

##What is this? Debinate started out as a way to let you roll your very own Python projects with a bunch of weird dependencies into little standalone Debian packages you can install into /opt. It has since gained the ability to turn any directory into a Debian package with the addition of the build command.

It's not meant to be a highly customizable packager with every option available under the sun but instead to just hit the low-hanging fruit of packaging applications to ease installation.

##Installation Drop the latest version of debinate into your $PATH, set it executable, and make sure you own /opt if you plan to use the Python package command:

sudo curl -o /usr/local/bin/debinate -L https://github.com/rholder/debinate/releases/download/v0.5.0/debinate && \
sudo chmod +x /usr/local/bin/debinate && \
sudo chown $USER:$USER /opt

If you're on a Debian/Ubuntu-based system, there's a .deb package available here.

##Usage

Debinate 0.5.0 - roll up your project into a Debian package

Python:

  debinate init     - create and initialize a Debinate project structure in .debinate
  debinate package  - creates a .deb file from your project in .debinate/build
  debinate build    - kitchen sink, specify all the things!
  debinate clean    - delete everything in the target, build, and cache folders

Advanced:

  debinate build - build a .deb from a directory
   -r, --root         root directory, e.g. ./root with ./root/usr/local/bin/thing inside
   -n, --name         project name (optional, default: current directory)
   -v, --version      project version (optional, default: 1.0.0)
   -d, --debian-dir   directory that contains debian package files, like control (optional)
   -o, --output       output .deb file location (optional, default: "./name-version.deb")

Examples:

  # everything you need to package up Python stuff
  debinate init
  debinate package
  debinate clean

  # minimal default to build a .deb from the given root directory
  debinate build -r ./build/root

  # kitchen sink, specify all the things!
  debinate build --root ./build/root --name potato --version 1.3.2 --debian-dir ./debian --output ./potato-123.deb

##Python For Python, create a setup.py for your project that isn't too crazy. If you can install it via a pip install ./ then you're probably good to go. Here's one to get you started that has a bunch of stuff in it:

#!/usr/bin/env python
import sys

from setuptools import setup

requires = ['argparse==1.2.1',
            'numpy==1.8.0',
            'pandas==0.12.0',
            'python-dateutil==2.2',
            'pytz==2013.8',
            'six==1.4.1',
            'wsgiref==0.1.2',
            'MySQL-python==1.2.4']

py_modules = ['my_cool_project_module']

packages = []

setup_options = dict(
    name='my_cool_project',
    version='1.0.0',
    description='My Cool Project',
    author='Cool Developer',
    author_email='',
    install_requires=requires,
    py_modules=py_modules,
    packages=packages
)

setup(**setup_options)

Initialize the .debinate project structure from the top level of your project:

debinate init

This will create some empty boilerplate that you can customize.

Package up your project:

debinate package

If you don't like what was built, you can clean out the build directories and start over with:

debinate clean

See examples for uses of the build command.

##License Debinate is released under version 2.0 of the Apache License.