Metadata-Version: 1.1
Name: fabsetup
Version: 0.7.10
Summary: fabric setup scripts and fabric utils library
Home-page: https://github.com/theno/fabsetup
Author: Theodor Nolte
Author-email: fabsetup@theno.eu
License: MIT
Description: fabsetup
        ========
        
        Fabric tasks in order to set up and maintain configurations, software
        installations and other things on a local or remote linux system (most
        functionality for Debian/Ubuntu).
        
            *"dotfiles on steroids"*
        
        Usage
        -----
        
        **fabsetup** is a **`fabric <http://www.fabfile.org/>`__** script.
        
        .. code:: sh
        
            # task infos
        
            ## list all tasks: '-l'
            fabsetup -l
        
            ## show details: '-d'
            fabsetup -d new_addon
        
        
            # run tasks
        
            fabsetup setup.regex_repl
        
            ## on your local host:
            fabsetup setup.pencil3 -H localhost
        
            ## remote host:
            fabsetup up -H example.com
        
        **`Setup-Howtos <./howtos>`__**:
        
        -  Customize fabsetup: `Initialize git repository
           ``fabsetup_custom`` <./howtos/fabsetup-custom.md>`__
        -  `Set up an environment without sudo access <./howtos/no-sudo.md>`__
        -  `Webserver Certificates with Letsencrypt <./howtos/letsencrypt.md>`__
        -  `Host an Owncloud Service <./howtos/owncloud.md>`__
        -  `Host an own F-Droid Repository <./howtos/f-droid-repo.md>`__
           (Android App Repository)
        -  `Host a Selfoss Service <./howtos/selfoss.md>`__ (RSS Reader Web
           Application)
        -  `Install latest Node.js via nvm <./howtos/nodejs.md>`__
        -  `Create or update a reveal.js presentation <./howtos/revealjs.md>`__
        -  **`How to create and write a
           fabsetup-addon <./howtos/fabsetup-addon.md>`__**
        
        Known fabsetup-addons
        ---------------------
        
        -  `fabsetup-theno-termdown <https://github.com/theno/fabsetup-theno-termdown>`__
        
        Please contribute: `Create your own
        fabsetup-addon <./howtos/fabsetup-addon.md>`__ and make a `pull
        request <https://github.com/theno/fabsetup/pulls>`__ which adds your
        fabsetup-addon to the ``known_pip_addons`` in ``fabsetup/addons.py`` and
        to this ``README.md``.
        
        Installation
        ------------
        
        As a `pypi package <https://pypi.python.org/pypi/fabsetup>`__ with
        command ``pip`` (recommended way):
        
        .. code:: sh
        
            pip install fabsetup
        
            # install addon, eg. fabsetup-theno-termdown
            pip install fabsetup-theno-termdown
        
        Update:
        
        .. code:: sh
        
            pip install --upgrade fabsetup
        
            # update addon (also updates fabsetup)
            pip install --upgrade fabsetup-theno-termdown
        
        Install without superuser privileges:
        
        .. code:: sh
        
            pip install --user fabsetup
        
        When running with ``--user``, pip installs the command ``fabsetup`` at
        ``~/.local/bin``. `Assure <https://stackoverflow.com/a/14638025>`__ that
        ``~/.local/bin`` is set in your ``$PATH`` environment variable.
        
        Uninstall:
        
        .. code:: sh
        
            pip uninstall --yes fabsetup
            pip uninstall --yes fabsetup-addon-theno
        
        You also can clone the `github
        repository <https://github.com/theno/fabsetup>`__ instead of using
        ``pip install``:
        
        .. code:: sh
        
            # install requirements
            sudo apt-get install  git  fabric
            pip install --user utlz
        
            git clone  https://github.com/theno/fabsetup.git  ~/.fabsetup
        
            # from ~/.fabsetup dir use `fab` instead of `fabsetup`
            cd ~/.fabsetup
            fab -l
        
        Development
        -----------
        
        Devel commands:
        
        .. code:: bash
        
            # save changes
            git commit -am 'I describe my changes'
        
            # upload to github
            git push origin master
        
            # update version number in fabsetup/_version.py
        
            # create and publish package at pypi
            fab -f fabfile-dev.py  pypi
        
            # clean up
            fab -f fabfile-dev.py  clean
        
Keywords: python development utilities library
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
