Metadata-Version: 2.0
Name: cliquery
Version: 0.4.3
Summary: a command line search engine and browsing tool
Home-page: https://github.com/huntrar/CLIQuery
Author: Hunter Hammond
Author-email: huntrar@gmail.com
License: MIT
Keywords: cliquery command line open bookmark console search answer
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: lxml

# cliquery

## a command-line browsing interface
cliquery is a command-line interface meant to bundle important features of a conventional browser and the quickness of the command-line. It supports previewing webpages, bookmarks, 'Feeling Lucky' searches, as well as regular web searches or simply entering URI's directly. cliquery is **_NOT_** a command-line browser such as Lynx, but it does have an interactive interface that makes it quick and easy to perform multiple searches and other operations. When a user decides to actually open a link, cliquery simply invokes their browser of choice! Supported in both Python 2.x and 3.x.

The results? Less clicking, faster results, and *no limitations to regular browsing!*

## Installation
* `pip install cliquery`
* [Sign up](https://developer.wolframalpha.com/portal/apisignup.html) for a WolframAlpha API key.
* Enter your API key and choice of browser in .cliqrc (cygwin users should enter `cygwin` as their browser). An example .rc file is available in cliquery/.cliqrc, or will be created after an initial run.

## Usage
usage: cliquery.py [-h] [-s] [-f] [-o] [-w] [-d] [-b] [-v] [QUERY [QUERY ...]]

a command-line browsing interfaace


&nbsp;&nbsp;positional arguments:

&nbsp;&nbsp;&nbsp;&nbsp;QUERY           keywords to search


&nbsp;&nbsp;optional arguments:

&nbsp;&nbsp;&nbsp;&nbsp;-h, --help      show this help message and exit

&nbsp;&nbsp;&nbsp;&nbsp;-s, --search    display search links

&nbsp;&nbsp;&nbsp;&nbsp;-f, --first     open first link

&nbsp;&nbsp;&nbsp;&nbsp;-o, --open      open link or browser manually

&nbsp;&nbsp;&nbsp;&nbsp;-w, --wolfram   display wolfram results

&nbsp;&nbsp;&nbsp;&nbsp;-d, --describe  display page snippet

&nbsp;&nbsp;&nbsp;&nbsp;-b, --bookmark  view and modify bookmarks

&nbsp;&nbsp;&nbsp;&nbsp;-c, --config    print location of config file

&nbsp;&nbsp;&nbsp;&nbsp;-v, --version   display current version


## Author
* Hunter Hammond (huntrar@gmail.com)

## Notes
* If you receive the following message when trying to add bookmarks:
    ```
    IOError: [Errno 13] Permission denied: '/usr/local/lib/python2.7/dist-packages/cliquery/.cliqrc'
    ```
Enter the following to fix:
    ```
    sudo chmod a+x /usr/local/lib/python2.7/dist-packages/cliquery/.cliqrc
    ```

* A search may return immediate results, such as calculations or facts, or instead a page of search results comprised of descriptive links to follow.

* Interactive use is as easy as passing the regular flag arguments into the link prompt; this overrides any preexisting flags and allows for more even more flexibility.
    ```
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    1. simple sentence - definition and examples of simple ...
    2. Leaflet.js - A Simple Example - CodeProject
    3. Simple random sample - Wikipedia, the free encyclopedia
    4. A Simple Guide to HTML - Welcome
    5. MVC3 DropDownListFor - a simple example? - Stack Overflow
    6. Using OpenGL on Windows: A Simple Example
    7. Reconstructing trees: A simple example - Evolution
    8. A Simple Example - Logarithms
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    : d 6


    http://www.cs.rit.edu/~ncs/Courses/570/UserGuide/OpenGLonWin-11.html

    NextPrevUpTopContentsIndex Using OpenGL on Windows: A Simple ExampleAny OpenGL program for Windows 
    has to take care of some window-dependent setup. There are several ways this setup can be done, for 
    example, using the GLUT library or using GDI and WGL directly. This guide focuses on using the 
    Windows OpenGL API directly.
    See more? (y/n): n
    ```
* Entering h or help will bring up the list of possible commands to pass to the prompt.

* To choose multiple links at once, a range may be specified by separating the start and end range with a dash. Leaving one end of the range blank will choose all links until the other end of that range. For example, given 10 links, entering 5- would effectively be the same as entering 5-10.

* Using the bookmarks flag with empty arguments will list all current bookmarks in .cliqrc, ordered by time of entry. To add a new bookmark, simply enter the url you wish to add as an argument. To open an existing bookmark, enter the corresponding bookmark number as listed as an argument. Bookmarks may also be added interactively through the link prompt like all other flags.


News
====

0.4.3
------

 - calling -o with no arguments opens browser in current directory

0.4.2
------

 - fixed version import

0.4.1
------

 - python 3 support, switched urllib2 to requests and other minor changes

0.4.0
------

 - rehaul of interactive mode, can now reuse most flags without exiting the prompt

0.3.3
------

 - added -c flag to print location of config

0.3.2
------

 - renamed CLIQuery to cliquery

0.3.1
------

 - improved description output readability 

0.3.0
------

 - fixed desc flag behavior when given standalone

0.2.9
------

 - proper checking for 'cygwin' as browser before writing errors

0.2.8
------

 - updates to .cliqrc creation and error messages

0.2.5
------

 - .cliqrc now created on first run

0.2.4
------

 - Now available on PyPI

0.2.3
------

 - First entry




