perform web searches from the command line
Project description
Usage
Usage: URLSEARCH_NAME query opens appropriate search query in a browser
urlsearch provides a shortcut to start a web search from the command line. It is designed to be symlinked from command names which refer to the target search engine; several are already included by default:
google
bing
ddg (DuckDuckGo)
pylib (search Python library reference)
pypi (search the Python Package Index)
wiki (search Wikipedia)
Features:
automatic guessing of top-level domains
special casing of query path and naming in a .ini-style config file
supports trac ticket searches (e.g. #1234) by omitting the leading ‘#’, which would otherwise be interpreted as a comment by the shell and dropped. (disabled by default - enable on a per-site basis in ~/.urlsearchrc)
supports local domains - if name can be resolved locally it will be used in preference to appending a suffix
Examples
These assume ‘google’, ‘wiki’, and ‘trac’ are urlsearch commands:
$ google photon mapping $ trac r19201 $ wiki path tracing
Default installation
Note the default installation adds a number of new commands to your PATH, as listed in the Usage overview above.
$ pip install urlsearch $ google python webbrowser # open web page
Manual installation
Cloning the repository locally and editing the content of scripts by deleting or creating symlinks is recommended to get a more custom set of search links.
~$ hg clone https://bitbucket.org/codedstructure/urlsearch ~$ cd urlsearch/scripts scripts$ rm google scripts$ ln -s urlsearch trac scripts$ cd .. urlsearch$ python3 setup.py install
Config File
urlsearch looks for a config file named .urlsearchrc in the current or home directory. It may be modified to configure the search behaviour of urlsearch on a per-site basis, as well as configuring some options. The .urlsearchrc file in the source distribution (symlinked to urlsearchrc for ease of development) is copied to the ~/.urlsearchrc on installation; the default installation instance is fully commented and self-documenting.
CHANGES
- 0.3:
support for .urlsearchrc config file
- 0.2:
change to use setuptools
add pypi search
- 0.1:
first release
TODO
Improved support for manually adding search types including simple special casing is planned.
Ben Bass 2012-2014 @codedstructure
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for urlsearch-0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 744218b9d1cb1e95d269578283415473032bda44a01af64402ca05125a8033ca |
|
MD5 | 1fb770d3aa5deb5b2bf6ad01ed3e9e91 |
|
BLAKE2b-256 | 13e4affc57ca2129d90d1980f8d18008f46114d222eed5a962277da135844ad6 |