Skip to main content

DuckDuckGo zero-click api for your command-line

Project description

Duck Duck Go zero-click api for your command-line

Install

$ pip install ddg

or from the source:

$ python setup.py install

Usage

ddg [-h] [-b] [-d] [-j] [-l] [-s] [-u] [query [query ...]]

www.duckduckgo.com zero-click api for your command-line

positional arguments:

query the search query

optional arguments:
-h, --help

show this help message and exit

-b, --bang

open the !bang redirect url in a new browser tab

-d, --define

return the definition result

-j, --json

return the zero-click info api json response

-l, --lucky

open the result url in a new browser tab

-s, --search

launch a DuckDuckGo search in a new browser tab

-u, --url

return the result url

Examples

Call ddg from your command line to access the Duck Duck Go Zero-Click Info API

$ddg red-black tree
A red–black tree is a type of self-balancing binary search tree, a data structure
used in computer science, typically used to implement associative arrays.

Get the url of the answer source

$ ddg red-black tree -u
https://en.wikipedia.org/wiki/Red-black_tree

Combinining flags behaves as expected

$ ddg schnauzer -d -u
http://www.merriam-webster.com/dictionary/schnauzer

Launch a !Bang redirect in your web browser with the -b flag

Launch a query on Wolfram Alpha

$ ddg wa integral of sin x / x from negative inf to inf -b

Launch a search on Stack Overflow

$ ddg so [c++11] lambda return values -b

Launch a search on Duck Duck Go with -s

$ ddg Lord of the Rings -s

Launch the result url directly with -l

$ ddg python webbrowser -l

ddg plays nice with other utilities in your shell

$ echo "shark" | ddg -dl
$ ddg welsh corgi -u | pbcopy
$ ls | ddg -du

Use -j to output the json response from the API

$ ddg simpsons characters -j >> file.txt

Thanks

The duckduckgo module is a modification from http://github.com/crazedpsyc/python-duckduckgo.
Original duckduckgo module source from http://github.com/mikejs/python-duckduckgo (outdated)

Release history

0.2.2 (2012-12-20)

  • Fixed the error handling for printing results with special characters

0.2.1 (2012-12-18)

  • When an exception is raised in the duckduckgo module, report the error and then return None. This allows ddg.py to continue to the next query rather than performing a sys.exit(1).

  • Updated README

  • Fixed formatting in LICENSE file

  • Changed CHANGES to an rst file

  • Updated the setup.py file

  • Updated the help for all the input arguments

0.2.0 (2012-12-17)

  • Changed the behavior of the -d flag. Rather than prefixing the query with define, now just prioritize the definition result when searching for an answer to the query.

  • Updated README with more examples.

0.1.7 (2012-12-16)

  • Added a new trove classifier and made code more PEP8 compliant

0.1.6 (2012-12-16)

  • Fixed an issue with the -b prefix, please upgrade to the latest version with pip install –upgrade ddg

0.1.5 (2012-12-15)

  • Updated license to MIT

0.1.4 (2012-12-15)

  • Using webbrowser rather than os dependent Popen commands

0.1.1 (2012-12-15)

  • First working version, initial release

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

ddg-0.2.2.tar.gz (6.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page