ecb-rates 1.1.0

Query exchange rates from the European Central Bank (ECB)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

# ECB Rates

<p style="text-align: center">
  <img
    src="images/Logo_European_Central_Bank.svg"
    width="200"
    alt="European Central Bank Logo"
    align="left"
  />
  A CLI utility to fetch exchange rates from the European Central Bank.
  <br />
  <br />
  <br />
  <br />
  <br />
  <br />
  <br />
</p>

## Install

### Binary

If you're on Debian Linux, then just go over to the releases, and install the latest _.deb_ package with `dpkg`

### Source

First, make sure that you have the rust toolchain installed. If not, then go to [rustup](https://rustup.rs) to install it.

Now, run the following cargo command:

```sh
cargo install ecb-rates
```

Congratulations! Now the cli binary `ecb-rates` will be in your cargo bin folder.

## Features

#### Fetch as many days as you want

It will fetch any of the following api nodes, and reduce them for you.

- Last available day.
- Last 90 days
- Since the dawn of the _EUR_

#### Display select currencies

- as an ASCII table
- in JSON prettified
- in JSON minified

#### Cache

It features an extensive cache, which will [calculate hollidays](src/holiday.rs) in order to know whether to invalidate it or not.

#### Show the rates in your way

Change the rates for the perspective of any currency with the `--perspective` or `-p` flag.

Flip it from `EUR to ALL` to `ALL to EUR` with the `--invert` or `-i` flag. It will work as expected with the _perspective_ option.

#### Fast

It wouldn't be a rust project without being _BLAZINGLY FAST_! When the cache is valid a single day will on my computer be shown in 3 ms. When the cache isn't being used it will be ~90ms. The cache speed will largely depend on your drive, the latter will depend on your network speed. Both options are fast enought to be in a `.bashrc` or `.zshrc`

### Examples

#### Show the original data from ECB

![eur-to-all](images/eur-to-all.png)

#### ...with only select currencies

![eur-to-all](images/eur-to-all-select.png)

#### Put the exchange rate in the perspective of any currency

![usd-to-all](images/usd-to-all.png)

#### Flip it

![all-to-usd](images/all-to-usd.png)

#### Show multiple days

![eur-to-all-multiple-days](images/eur-to-all-multiple-days.png)

## Acknowledgment

The data is (obviously) provided by the [European Central Bank](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html)