Skip to content

USD-BRL CLI is a tool that allows developers to fetch the exchange rate of USD/BRL on the 15th workday of the previous month.

License

Notifications You must be signed in to change notification settings

dberri/usdbrl-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

USD-BRL CLI

Twitter Follow

USD-BRL CLI is a tool that allows developers to fetch the exchange rate of USD/BRL on the 15th workday of the previous month.

To file taxes in Brazil for foreign earnings, one needs to convert that income to USD using the closed exchange rate of the payment date and then convert to BRL using the exchange rate on the 15th workday of the previous month.

The data comes from the oficial website for the Brazilian Central Bank

Prerequisites

Before you begin, ensure you have met the following requirements:

  • You have Node.js installed in your machine.
  • You have an internet connection.

Installing usdbrl-cli

To install usdbrl-cli, follow these steps:

using npm:

npm install -g usdbrl-cli

Using usdbrl-cli

To use usdbrl-cli, follow these steps:

Get the exchange rate on the 15th workday of the past month

> usdbrl
Exchange rate on 15/06/2020: R$ 5,1877

Get the exchange rate on a specific date

> usdbrl -d 10/06/2020
Exchange rate on 10/06/2020: R$ 4,8888

Get the exchange rate for a period

> usdbrl -r -p 05/07/2020 10/07/2020
[
  { date: '30/06/2020', rate: '5,4754' },
  { date: '01/07/2020', rate: '5,3646' },
  { date: '02/07/2020', rate: '5,3022' },
  { date: '03/07/2020', rate: '5,3368' }
]

Contributing to usdbrl-cli

To contribute to usdbrl-cli, follow these steps:

  1. Fork this repository.
  2. Create a branch: git checkout -b <branch_name>.
  3. Make your changes and commit them: git commit -m '<commit_message>'
  4. Push to the original branch: git push origin usdbrl-cli/<location>
  5. Create the pull request.

Alternatively see the GitHub documentation on creating a pull request.

Contact

If you want to contact me you can reach me at david@berribits.com.

License

This project uses the following license: MIT.

About

USD-BRL CLI is a tool that allows developers to fetch the exchange rate of USD/BRL on the 15th workday of the previous month.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published