erlduck

erlduck is a DuckDuckGo Instant Answers API client written in Erlang/OTP.

Summary

In a nutshell, erlduck is an HTTP client application that sends HTTP requests to api.duckduckgo.com and returns the result. It uses unix1/httpclient using ninenines/gun as its HTTP backend. This means erlduck will keep configured number of workers (default 1) persistently connected to DuckDuckGo service for fast response times.

Prerequisites

• Erlang/OTP

Run

• run in shell

make run

• run tests (assumes connectivity to api.duckduckgo.com)

make tests

Play

• after running in shell, you can start the client pool

ok = erlduck:start().

• and then make requests using that pool

{ok, Response} = erlduck:answer(<<"what is erlang">>).

• by default the response will be JSON binary. To use XML instead

{ok, Response} = erlduck:answer(<<"what is erlang">>, xml).

• to start with custom options (map may contain one more keys below):

ok = erlduck:start(#{name => other, pool_size => 2, pool_overflow => 2}).

• and then use the custom pool for requests

{ok, Response} = erlduck:answer(other, <<"snakes on a plane">>).

• you can still return the response in XML

{ok, Response} = erlduck:answer(other, <<"snakes on a plane">>, xml).