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.9.tar.gz (13.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

FxPy-1.1.9-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for fxpy-1.1.9.tar.gz
Algorithm Hash digest
SHA256 fc2e6c3814c9d740232806b24319a430a5a6e2d06007f11f37067ad1a11220ec
MD5 89e60f445557b8cbe5e99e6ea0cd6a55
BLAKE2b-256 59d2d0d413e65b2a80eecb114d0424492280e436b255bea7b5c79e3f11a1e1eb

See more details on using hashes here.

File details

Details for the file FxPy-1.1.9-py3-none-any.whl.

File metadata

  • Download URL: FxPy-1.1.9-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.2

File hashes

Hashes for FxPy-1.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 a857f5680497a5aba7df525022f46d695a36f29c886fc8038636e2605ac6a9ba
MD5 b9be7ea1e451f452c1f78c97b3b5b266
BLAKE2b-256 b9f5487561345914699c132e16148297cd38c676217f93478165dee9aacfb780

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