<commit_before>Gondl - Command line console for Quandl
=======================================

Gondl provides command line access to the 
[Quandl API](https://www.quandl.com/help/api).

It was developed in Go.

## Features

* Support for getting a single or multiple symbols at once
* Support for getting a list of symbols in a data source
* Support for searching Quandl
* Shows/saves JSON, CSV or XML
* Built in local file cache


## Download Windows Binary

You can download the latest build of `gondl.exe` in the 
[releases tab](https://github.com/DannyBen/gondl/releases)


## Build from Source

[Install Go](https://golang.org/doc/install), then:

	$ go get github.com/DannyBen/gondl
	$ cd $GOPATH/src/github.com/DannyBen/gondl
	$ go build

## Examples

Get data for Apple stock:

	gondl get WIKI/AAPL

Get 3 rows of data as JSON, and use an API Key:

	gondl get WIKI/AAPL -r3 -fjson -kYOUR_KEY

Save multiple symbols as XML to a file:

	gondl get WIKI/AAPL WIKI/CSCO -fxml -oOutFile.txt --rows 10

Get a list of symbols in a source:

	gondl list WIKI --page 1 --per_page 10

Get search results:

	gondl search "crude oil" --page 1 --per_page 10


## Usage:
    gondl --help | -h  
    gondl --version | -v  
    gondl --config  
    gondl get <symbol>... [options]  
    gondl list <source> [options]  
    gondl search <query> [options]  

## Standalone Options:  
    -h, --help                Show this help  
    -v, --version             Show version details  
        --config              Create a default config.json file  
                              You may place any of the --options in it  

## Global Options:  
    -k, --apikey <key>        Send this api key with the request  
    -f, --format <format>     Output as csv, json or xml [default: csv]  
    -o, --out <file>          Save to file  
    -u, --url                 Show the request URL  
    -d, --debug               Show all registered arguments  
    -C, --cachedir <dir>      Set cache directory [default: ./cache]  
    -c, --cache <mins>        Set cache life to <mins> minutes, 0 to disable   
                              [default: 240]  

## Get Options:  
    -n, --column <n>          Request data column <n> only  
    -r, --rows <n>            Request <n> rows  
    -t, --trim_start <date>   Start data at <date>, format yyyy-mm-dd  
    -T, --trim_end <date>     End data at <date>, format yyyy-mm-dd  
    -s, --sort_order <order>  Set sort order to asc or desc  

## Search/List Options:  
    -p, --page <n>            Start at page <n> [default: 1]  
    -P, --per_page <n>        Show <n> results per page [default: 300]  
<commit_msg>Minor readme update<commit_after>Gondl - Command line console for Quandl
=======================================

Gondl provides command line access to the 
[Quandl API](https://www.quandl.com/help/api).

It was developed in Go.

## Features

* Support for getting a single or multiple symbols at once
* Support for getting a list of symbols in a data source
* Support for searching Quandl
* Shows/saves JSON, CSV or XML
* Built in local file cache


## Download Windows Binary

[Download the latest build of gondl.exe](https://github.com/DannyBen/gondl/releases)


## Build from Source

[Install Go](https://golang.org/doc/install), then:

	$ go get github.com/DannyBen/gondl
	$ cd $GOPATH/src/github.com/DannyBen/gondl
	$ go build

## Examples

Get data for Apple stock:

	gondl get WIKI/AAPL

Get 3 rows of data as JSON, and use an API Key:

	gondl get WIKI/AAPL -r3 -fjson -kYOUR_KEY

Save multiple symbols as XML to a file:

	gondl get WIKI/AAPL WIKI/CSCO -fxml -oOutFile.txt --rows 10

Get a list of symbols in a source:

	gondl list WIKI --page 1 --per_page 10

Get search results:

	gondl search "crude oil" --page 1 --per_page 10


## Usage:
    gondl --help | -h  
    gondl --version | -v  
    gondl --config  
    gondl get <symbol>... [options]  
    gondl list <source> [options]  
    gondl search <query> [options]  

## Standalone Options:  
    -h, --help                Show this help  
    -v, --version             Show version details  
        --config              Create a default config.json file  
                              You may place any of the --options in it  

## Global Options:  
    -k, --apikey <key>        Send this api key with the request  
    -f, --format <format>     Output as csv, json or xml [default: csv]  
    -o, --out <file>          Save to file  
    -u, --url                 Show the request URL  
    -d, --debug               Show all registered arguments  
    -C, --cachedir <dir>      Set cache directory [default: ./cache]  
    -c, --cache <mins>        Set cache life to <mins> minutes, 0 to disable   
                              [default: 240]  

## Get Options:  
    -n, --column <n>          Request data column <n> only  
    -r, --rows <n>            Request <n> rows  
    -t, --trim_start <date>   Start data at <date>, format yyyy-mm-dd  
    -T, --trim_end <date>     End data at <date>, format yyyy-mm-dd  
    -s, --sort_order <order>  Set sort order to asc or desc  

## Search/List Options:  
    -p, --page <n>            Start at page <n> [default: 1]  
    -P, --per_page <n>        Show <n> results per page [default: 300]  

{'fraction_non_alphanumeric': 0.11755754232451969, 'fraction_numerical': 0.0068480121742438655, 'mean_word_length': 2.0253164556962027, 'pattern_counts': {'":': 0, '<': 47, '<?xml version=': 0, '>': 47, 'https://': 6, 'lorem ipsum': 0, 'www.': 2, 'xml': 4}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6970301', 'n_tokens_mistral': 1803, 'n_tokens_neox': 1707, 'n_words': 654}