{"id":19807655,"url":"https://github.com/westurner/web.sh","last_synced_at":"2025-05-01T07:31:44.318Z","repository":{"id":62588559,"uuid":"37838751","full_name":"westurner/web.sh","owner":"westurner","description":"web.sh is a python script ($ web (websh.py)) and API for launching a browser (with x-www-browser (Linux, Unix), open (OSX), start (Windows), or python -m webbrowser)","archived":false,"fork":false,"pushed_at":"2015-06-22T11:12:23.000Z","size":164,"stargazers_count":2,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2024-09-19T08:38:23.545Z","etag":null,"topics":["browser-detection","command-line-tool","python-script"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/web.sh","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/westurner.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-22T05:20:20.000Z","updated_at":"2020-08-25T10:10:54.000Z","dependencies_parsed_at":"2022-11-03T17:01:56.458Z","dependency_job_id":null,"html_url":"https://github.com/westurner/web.sh","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/westurner%2Fweb.sh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/westurner%2Fweb.sh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/westurner%2Fweb.sh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/westurner%2Fweb.sh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/westurner","download_url":"https://codeload.github.com/westurner/web.sh/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224245976,"owners_count":17279649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-detection","command-line-tool","python-script"],"created_at":"2024-11-12T09:11:35.686Z","updated_at":"2024-11-12T09:11:36.153Z","avatar_url":"https://github.com/westurner.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"===============================\nweb.sh\n===============================\n.. image:: https://img.shields.io/travis/westurner/web.sh.svg\n        :target: https://travis-ci.org/westurner/web.sh\n\n.. image:: https://img.shields.io/pypi/v/web.sh.svg\n        :target: https://pypi.python.org/pypi/web.sh\n\n\nweb.sh is a cross-platform script (web) and API for launching a browser\n(with ``x-www-browser`` (Linux, Unix), ``open`` (OSX), ``start`` (Windows),\nor ``python -m webbrowser``)\n\n* Free software: BSD license\n* PyPI: https://pypi.python.org/pypi/web.sh\n* Warehouse: https://warehouse.python.org/project/web.sh\n* Source: https://github.com/westurner/web.sh\n\n\n.. contents::\n\n\nFeatures\n--------\n\n* Open the configured default system web browser with one or more\n  paths or URIs\n* Open to a relative path\n* Open to an absolute path\n\n\nInstallation\n--------------\nInstall the ``web`` (and ``x-www-browser-``) scripts:\n\n.. code:: bash\n\n   pip install web.sh\n   pip install -e https://github.com/westurner/web.sh\n\n\nUsage\n-------\n\nThe ``web`` script commandline interface:\n\n.. code:: bash\n\n    web .\n    web ./index.html\n    web $WORKON_HOME/dotfiles/src/dotfiles/docs/_build/html/index.html\n    web localhost:8082   #  pgs docs/_build/html  # pypi:pgs\n    web https://westurner.org/dotfiles/\n    web westurner.org/dotfiles github.com/westurner/dotfiles  # !HTTPS!\n    x-www-browser- .\n\n``web --help`` commandline help::\n\n    Usage: websh.py [-b|-x|-o|-s] [-v|-q] \u003curl1\u003e [\u003curl_n\u003e]\n\n    Open paths or URIS as tabs in the configured system default webbrowser\n\n    Options:\n      -h, --help           show this help message and exit\n      -b, --webbrowser     Open with `python -m webbrowser`\n      -x, --x-www-browser  Open with `x-www-browser` (Linux, X)\n      -o, --open           Open with `open` (OSX)\n      -s, --start          Open with `start` (Windows)\n      -v, --verbose        \n      -q, --quiet          \n      -t, --test          \n\n\nAPI\n----\n* Instances of ``websh.websh.WebBrowser`` implement ``open_new_tab()``\n* ``websh.websh.WebBrowser.x_www_browser`` calls ``open_new_tab()``\n  with a list of paths and/or URIs\n* ``web \u003curls\u003e`` calls ``websh.websh.WebBrowser.x_www_browser``\n  to open new tabs for each path or URI:\n\n  .. code:: python\n\n      urls = ([\"https://westurner.org/dotfiles/\",\n               \"https://github.com/westurner/dotfiles\",\n               \"https://waffle.io/westurner/dotfiles\"])\n      output = list(WebBrowser.x_www_browser(urls))\n      print(output)\n\n\nPlatform Notes\n---------------\n* OSX: ``web -o ./README.rst`` and ``web -b ./README.rst``\n  open ``README.rst`` in the configured editor\n  (not the configured system browser).\n\n  Workarounds:\n\n  * Specify the full path to a specific browser application followed\n    by a quoted URI, for each URI in a newline-delimited list\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwesturner%2Fweb.sh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwesturner%2Fweb.sh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwesturner%2Fweb.sh/lists"}