Metadata-Version: 2.1
Name: mork
Version: 0.1.2
Summary: A project for installing packages across the virtualenv boundary.
Home-page: https://github.com/sarugaku/mork
Author: Dan Ryan
Author-email: dan@danryan.co
License: ISC License
Keywords: package management,package installer,virtual environment,pipenv,requirementslib,pipfile,dependencies,dependency management
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=2.6,!=3.0,!=3.1,!=3.2,!=3.3
Provides-Extra: tests
Requires-Dist: cached-property
Requires-Dist: distlib
Requires-Dist: pip-shims
Requires-Dist: recursive-monkey-patch
Requires-Dist: setuptools
Requires-Dist: six
Requires-Dist: virtualenv
Requires-Dist: vistir[spinner]
Provides-Extra: tests
Requires-Dist: pytest-timeout; extra == 'tests'
Requires-Dist: pytest-xdist; extra == 'tests'
Requires-Dist: pytest-cov; extra == 'tests'
Requires-Dist: pytest; extra == 'tests'

===============================================================================
mork: A project for installing packages across the virtualenv boundary.
===============================================================================

.. image:: https://img.shields.io/pypi/v/mork.svg
    :target: https://pypi.org/project/mork

.. image:: https://img.shields.io/pypi/l/mork.svg
    :target: https://pypi.org/project/mork

.. image:: https://api.travis-ci.com/sarugaku/mork.svg?branch=master
    :target: https://travis-ci.com/sarugaku/mork

.. image:: https://ci.appveyor.com/api/projects/status/y9kpdaqy4di5nhyk/branch/master?svg=true
    :target: https://ci.appveyor.com/project/sarugaku/mork

.. image:: https://img.shields.io/pypi/pyversions/mork.svg
    :target: https://pypi.org/project/mork

.. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg
    :target: https://saythanks.io/to/techalchemy

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

Summary
=======

Mork_ is a library designed for installing and querying python packages inside virtual
environments.


🐉 See What's Installed
-----------------------

  ::

    >>> import mork
    >>> venv = mork.VirtualEnv.from_project_path('/home/user/git/pipenv')
    >>> dists = venv.get_distributions()
    >>> [dist for dist in dists][:3]
    [wheel 0.31.1 (/home/user/.virtualenvs/pipenv-MfOPs1lW/lib/python3.7/site-packages), Werkzeug 0.14.1 (/home/user/.virtualenvs/pipenv-MfOPs1lW/lib/python3.7/site-packages), vistir 0.1.4 (/home/user/.virtualenvs/pipenv-MfOPs1lW/lib/python3.7/site-packages)]


🐉 Install A Package
--------------------

  ::

    >>> from requirementslib.models.requirements import Requirement
    >>> r = Requirement.from_line("requests")
    >>> venv.install(r, editable=False)


🐉 Uninstall a Package
----------------------

  ::

    >>> pkg = "pytz"
    >>> with venv.uninstall(pkg, auto_confirm=True) as uninstall:
            if uninstall.paths:
                cleaned = pkg
    >>> print("Removed package: %s" % cleaned)


🐉 Display Information about Python
-----------------------------------

  ::

    >>> venv.python
    '/home/user/.virtualenvs/pipenv-MfOPs1lW/bin/python'
    >>> venv.python_version
    '3.7'


🐉 Run Commands Inside the Virtualenv
-------------------------------------

  ::

    >>> cmd = venv.run("env")
    >>> [line for line in cmd.out.splitlines() if line.startswith("VIRTUAL_ENV")]
    ['VIRTUAL_ENV=/user/hawk/.virtualenvs/pipenv-MfOPs1lW']
    >>> cmd = venv.run_py(["import os; print(os.environ.get('VIRTUAL_ENV'))"])
    Deactivating virtualenv...
    >>> cmd.out
    '/home/user/.virtualenvs/pipenv-MfOPs1lW\n'
    >>> with venv.activated():
            print(os.environ["VIRTUAL_ENV"])
    /home/hawk/.virtualenvs/pipenv-MfOPs1lW


`Read the documentation <https://mork.readthedocs.io/>`__.


