Skip to main content

ForexPy: A currency conversion tool that also scraps the web and gives the Forex Exchange rates from major services.

Project description

ForexPy

A command-line tool for currency conversion that fetches live Forex exchange rates from popular exchange services using web scraping.

Motivation

When sending money to another country, how to choose which service to use?

  • You could google the conversion ,visit every site and compare the rates to find the best exchange rate

OR

  • Use ForexPy and get rates from major services with a single command!

Personally, I was frustated whenever I needed to do a foreign transaction. If I choose one service due to its better rate next time the same service might be offering the worst rate. Therefore, I created ForexPy to save myself time, hassle and money.

Quick Start

For Windows, try to use the terminal as an Administrator.

For Linux, this tool requires root access (because of usage of keyboard library). To run terminal as root, use the following command:

sudo su
# enter the password

Linux Root Terminal Example

After gaining root or admin privileges continue with the following steps:

Install ForexPy using:

  • Pypi
pip install fxpy
  • Git
pip install git+https://github.com/navrajkalsi/forexpy.git
  • Clone the Repo
git clone https://github.com/navrajkalsi/forexpy
cd forexpy
pip install .

Usage

After Installation is complete, ForexPy can be used in the following ways:

  • With Arguments: If you know the ISO Alpha 3 Codes of the currencies you want to convert, simply use the following command and pass the currency codes as arguments. The below example uses 'CAD' and 'INR'.
Flag Flag Description
-s Sender Currency Code
-r Receiver Currency Code
-v Current Version of Tool
# codes are case insensitive

fxpy --sender CAD --receiver INR
# or
fxpy -s cad -r inr

CAD to INR Example Conversion

  • Without Arguments: If you do not know the exact currency codes, then you could just enter the following command and follow the instructions by entering in the respective country names (these names do not need to be perfect, the program will help in choosing the correct names).
fxpy

CAD to INR Example Conversion

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fxpy-1.1.6.tar.gz (13.8 kB view details)

Uploaded Source

File details

Details for the file fxpy-1.1.6.tar.gz.

File metadata

  • Download URL: fxpy-1.1.6.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for fxpy-1.1.6.tar.gz
Algorithm Hash digest
SHA256 2deae38fe406935a0a7990fa0083062e96ba12b5e9d6e22f76506fcd92341330
MD5 402cd40d91200ceae107eb9318491cc2
BLAKE2b-256 68009732c5bc34ba833975ec1f6bc806b9c44c151b711da03a85cd06c61a32aa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page