Metadata-Version: 1.1
Name: fabvenv
Version: 0.2.0
Summary: A fabric utility for creating remote virtual environments, and installing and updating packages.
Home-page: https://github.com/todddeluca/fabvenv
Author: Todd Francis DeLuca
Author-email: todddeluca@yahoo.com
License: MIT
Description: # fabvenv
        
        A fabric utility for creating remote virtual environments, and installing and
        updating packages.
        
        The basic use case this covers is logging into a remote host, downloading
        virtualenv.py, using it to create a virtual environment for a project,
        including installing `pip`, and then installing packages, based on a
        "requirements.txt" file.
        
        ## Installation
        
        ```
        pip install fabvenv
        ```
        
        ## Usage
        
        Here is how I define Fabric tasks to create a virtual environment, install
        packages, add a directory to the `sys.path` of the python executable, etc.:
        
        ```
        @task
        def venv_create():
            require('configured')
            venv = fabvenv.Venv(config.venv, config.requirements)
            if not venv.exists():
                venv.create(config.system_python)
        
        
        @task
        def venv_install():
            require('configured')
            fabvenv.Venv(config.venv, config.requirements).install()
        
        
        @task
        def venv_upgrade():
            require('configured')
            fabvenv.Venv(config.venv, config.requirements).upgrade()
        
        
        @task
        def venv_freeze():
            require('configured')
            fabvenv.Venv(config.venv, config.requirements).freeze()
        
        
        @task
        def venv_remove():
            require('configured')
            venv = fabvenv.Venv(config.venv, config.requirements)
            if venv.exists():
                venv.remove()
        
        
        @task
        def venv_pth():
            '''
            Add the code directory to the virtualenv sys.path.
            '''
            require('configured')
            fabvenv.Venv(config.venv, config.requirements).venv_pth([config.code])
        ```
        
        ## Contribute
        
        Pull requests and issues are welcomed.
        
        ## Testing
        
        The file `tests/fabfile.py` is a basic test of using fabric and fabvenv to
        create a virtual environment, install a package, upgrade a package, and remove
        the virtual environment.
        
        To run this test, you must have fabric installed, and you must be able to
        do passwordless (keypair) ssh into localhost as `$USER`, I assume.
        
        Run the tests as follows:
        
            cd tests/
            fab test_fabvenv
        
        
        
Keywords: fabric virtualenv venv utility
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
