Metadata-Version: 2.1
Name: whichcraft
Version: 0.4.1
Summary: This package provides cross-platform cross-python shutil.which functionality.
Home-page: https://github.com/pydanny/whichcraft
Author: Daniel Roy Greenfeld
Author-email: pydanny@gmail.com
License: BSD
Keywords: whichcraft
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
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
Classifier: Programming Language :: Python :: 3.6
License-File: LICENSE
License-File: AUTHORS.rst

===============================
whichcraft
===============================

.. image:: https://badge.fury.io/py/whichcraft.svg
    :target: http://badge.fury.io/py/whichcraft

.. image:: https://travis-ci.org/pydanny/whichcraft.svg?branch=master
        :target: https://travis-ci.org/pydanny/whichcraft

.. image:: http://codecov.io/github/pydanny/whichcraft/coverage.svg?branch=master
        :target: http://codecov.io/github/pydanny/whichcraft?branch=master

.. image:: https://ci.appveyor.com/api/projects/status/v9coijayykhkeu4d?svg=true
        :target: https://ci.appveyor.com/project/pydanny/whichcraft

::

    That code in my care
    That sly command-line stare
    That strips my operating system bare
    It's whichcraft

This package provides cross-platform cross-python ``shutil.which`` functionality.

Usage
=====

On Linux, Mac, Windows for Python 2.6, 2.7, or any of the 3s:

.. code-block:: python

    >>> from whichcraft import which
    >>> which('date')
    '/bin/date'
    >>> which('calendar')
    '/bin/calendar'
    >>> which('cookiecutter')
    '/Users/pydanny/.envs/fun/bin/cookiecutter'
    >>> which('a-made-up-name') is None
    True


Notes
=====

This is a shim of the ``shutil.which`` function that's designed to work across
multiple versions of Python and inside of windows. The code for Python 2.x is
based on Python 3 code that I extracted from source. I originally did this for
Cookiecutter_ but pulled it out in order to reduce line count for that project.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter


History
=========

0.4.1 (2017-04-25)
---------------------

* Added tests to support Python 3.6


0.3.1 (2016-05-10)
---------------------

* Now testing for `which` directly, so we can support versions of Python 3 before 3.3 (@nickcoghlan)

0.3.1 (2016-04-24)
---------------------

* Correcting version in whichcraft.py

0.3.0 (2016-04-24)
---------------------

* Include tests in release source tarball (@Edwardbetts)

0.2.0 (2016-04-23)
---------------------

* Python 3.5 compatability

0.1.1 (2015-09-09)
---------------------

* Added lyrics

0.1.0 (2015-09-09)
---------------------

* First release on PyPI.


