Metadata-Version: 1.1
Name: web.sh
Version: 0.1.4
Summary: web.sh is a cross-platform script (web) and API for launching a browser(with x-www-browser (Linux, Unix), open (OSX), start (Windows),or python -m webbrowser)
Home-page: https://github.com/westurner/web.sh
Author: Wes Turner
Author-email: wes@wrd.nu
License: BSD
Description: ===============================
        web.sh
        ===============================
        .. image:: https://img.shields.io/travis/westurner/web.sh.svg
                :target: https://travis-ci.org/westurner/web.sh
        
        .. image:: https://img.shields.io/pypi/v/web.sh.svg
                :target: https://pypi.python.org/pypi/web.sh
        
        
        web.sh is a cross-platform script (web) and API for launching a browser
        (with ``x-www-browser`` (Linux, Unix), ``open`` (OSX), ``start`` (Windows),
        or ``python -m webbrowser``)
        
        * Free software: BSD license
        * PyPI: https://pypi.python.org/pypi/web.sh
        * Warehouse: https://warehouse.python.org/project/web.sh
        * Source: https://github.com/westurner/web.sh
        
        
        .. contents::
        
        
        Features
        --------
        
        * Open the configured default system web browser with one or more
          paths or URIs
        * Open to a relative path
        * Open to an absolute path
        
        
        Installation
        --------------
        Install the ``web`` (and ``x-www-browser-``) scripts:
        
        .. code:: bash
        
           pip install web.sh
           pip install -e https://github.com/westurner/web.sh
        
        
        Usage
        -------
        
        The ``web`` script commandline interface:
        
        .. code:: bash
        
            web .
            web ./index.html
            web $WORKON_HOME/dotfiles/src/dotfiles/docs/_build/html/index.html
            web localhost:8082   #  pgs docs/_build/html  # pypi:pgs
            web https://westurner.org/dotfiles/
            web westurner.org/dotfiles github.com/westurner/dotfiles  # !HTTPS!
            x-www-browser- .
        
        ``web --help`` commandline help::
        
            Usage: websh.py [-b|-x|-o|-s] [-v|-q] <url1> [<url_n>]
        
            Open paths or URIS as tabs in the configured system default webbrowser
        
            Options:
              -h, --help           show this help message and exit
              -b, --webbrowser     Open with `python -m webbrowser`
              -x, --x-www-browser  Open with `x-www-browser` (Linux, X)
              -o, --open           Open with `open` (OSX)
              -s, --start          Open with `start` (Windows)
              -v, --verbose        
              -q, --quiet          
              -t, --test          
        
        
        API
        ----
        * Instances of ``websh.websh.WebBrowser`` implement ``open_new_tab()``
        * ``websh.websh.WebBrowser.x_www_browser`` calls ``open_new_tab()``
          with a list of paths and/or URIs
        * ``web <urls>`` calls ``websh.websh.WebBrowser.x_www_browser``
          to open new tabs for each path or URI:
        
          .. code:: python
        
              urls = (["https://westurner.org/dotfiles/",
                       "https://github.com/westurner/dotfiles",
                       "https://waffle.io/westurner/dotfiles"])
              output = list(WebBrowser.x_www_browser(urls))
              print(output)
        
        
        Platform Notes
        ---------------
        * OSX: ``web -o ./README.rst`` and ``web -b ./README.rst``
          open ``README.rst`` in the configured editor
          (not the configured system browser).
        
          Workarounds:
        
          * Specify the full path to a specific browser application followed
            by a quoted URI, for each URI in a newline-delimited list
        
        
        
        
        
        ========
        History
        ========
        
        0.1.1 (2015-06-21)
        ---------------------
        
        * DOC: README.rst: links, Features, Usage, API
        * BLD: setup.py console_script entrypoint ``web = websh.web:main``
        * BLD: setup.py console_script entrypoint ``x-www-browser- = websh.web:main``
        * BUG,REF: websh.py: logging, logging config [07f9a0f]
        * BUG,CLN,DOC,REF,TST: websh.py: match_domain, :PymodeLintAuto, argv, logging config [4b33395]
        * ENH: websh.py: https://github.com/westurner/dotfiles/blob/master/scripts/web [29c0ca7]
        * BLD,RLS: \*, setup.py, __init__.py: ``cookiecutter gh:audreyr/cookiecutter-pypackage`` [e288536]
        
        0.1.2 (2015-06-21)
        -------------------
        * DOC: README.rst: API docs
        * RLS: setup.py, __init__.py: ``__version__ = 0.1.2``
        * First release on PyPI
        
        0.1.3 (2015-06-21)
        -------------------
        * DOC: README.rst, HISTORY.rst: formatting, links, release notes
        
        0.1.4 (2015-06-21)
        -------------------
        * RLS: setup.py, __init__.py: __version = '0.1.4' [8e33773]
        * BUG: websh.py: py26, py34 compat [a6ed31a]
        * BLD: tox.ini, .travis.yml: commands = python websh/websh.py -v -t [295abab]
        * DOC: websh.py, README.rst: usage docstrings [d054b43]
        * DOC: README.rst: links [bc1d06c]
        
Keywords: websh browser webbrowser x-www-browser
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-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.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
