# papertrail-downloader

[![Rust](https://github.com/ndelvalle/papertrail-downloader/workflows/Rust/badge.svg?branch=master)](https://github.com/ndelvalle/papertrail-downloader/actions?query=workflow%3ARust)

`papertrail-downloader` is a tool to download [Papertrail](https://www.papertrail.com/) archive logs. Especially useful when downloading a large number of archives.
This program is faster than the papertrail [suggested approach](https://help.papertrailapp.com/kb/how-it-works/permanent-log-archives/#download-a-large-number-of-archives) because `papertrail-downloader` download logs in parallel.


## Install

### Cargo

```
cargo install papertrail-downloader
```

### Manually

Download the latest [released binary](https://github.com/ndelvalle/papertrail-downloader/releases)
and add executable permissions:

```
wget -O papertrail-downloader "https://github.com/ndelvalle/papertrail-downloader/releases/download/v0.2.0/papertrail-downloader-x86-64-linux"
chmod +x papertrail-downloader
```

## Use

### Command line interface

```
papertrail-downloader 0.2.0
ndelvalle <nicolas.delvalle@gmail.com>
Papertrail parallel log archives downloader

USAGE:
    papertrail-downloader [OPTIONS] --start-date <start-date> --token <token>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -e, --end-date <end-date>        End date using 'YYYY-MM-DD' format [default: 2021-11-10]
    -o, --output-dir <output-dir>    Output directory to store downloaded logs [default: ./]
    -s, --start-date <start-date>    Start date using 'YYYY-MM-DD' format
    -t, --token <token>              Papertrail API token from https://papertrailapp.com/account/profile
```

### Example

```bash
$ ./papertrail-downloader --start-date 2020-01-01 --token xxxxxxxxxxxxxxxxxxx --output-dir ./ppt-logs
```