Metadata-Version: 2.1
Name: pytoport
Version: 0.4.1
Summary: Generate FreeBSD Makefiles from Python modules on PyPI
Home-page: https://github.com/freebsd/pytoport/
Author: Brendan Molloy
Author-email: brendan+pypi@bbqsrc.net
License: BSD-2-Clause
Keywords: freebsd makefile pypi module
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
License-File: LICENSE

pytoport
========

A fairly normal way to generate FreeBSD port Makefiles straight from
PyPI.

Installation
------------

FreeBSD
~~~~~~~

You can install ``pytoport`` using
`pkg(8) <https://github.com/freebsd/pkg>`__, or the Ports framework:

::

    $ pkg install -g pyXY-pytoport # Where XY is Python version eg. 34
    or
    $ make -C /usr/ports/ports-mgmt/py-pytoport install clean

From source (for development)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

It is recommended to create a ``virtualenv`` to install your
dependencies in order to not pollute your system installation:

::

    $ virtualenv --python=python3.X /path/to/venv
    $ source /path/to/venv/bin/activate
    $ pip install -r requirements.txt

You can then install from the ``setup.py`` directly, use ``pip``, or run
locally with:

::

    $ python -m pytoport

Usage
-----

You specify a base directory for the packages to be generated into, then
just let it rip!

::

    $ pytoport ~/my-ports/devel nosetests fixtures

In your ``~/my-ports/devel`` directory, you will find ``py-nosetests``
and ``py-fixtures`` with a ``Makefile`` and if you're lucky, a
``distinfo`` and ``pkg-descr`` too.

You should also create a ``~/.porttools`` file with the following
details:

::

    EMAIL="your@email.address"
    FULLNAME="Your Name"

See ``man 5 porttools`` for more information. If you don't create this
file, you'll have to fill out the relevant parts of the ``Makefile``
yourself.

License
-------

BSD 2-clause. See LICENSE.
