Metadata-Version: 2.1
Name: google_currency
Version: 1.0.9
Summary: A simple library to convert the currency of one country to other, it supports 153 countries' currency
Home-page: https://github.com/om06/google-currency
Author: Hariom Tiwari
Author-email: hariom.tiwari.006@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Description-Content-Type: text/markdown
License-File: LICENSE

# Google currency  

**Disclaimer:** This package fetch the result from Google using web scrapping. 
Owner will not be responsible for any misuse of this package. This is solely for 
the purpose of learning.   

A very simple currency converter.  
  
It can convert the currency of **153 codes.**  
  
Since the results are fetched from ``Google`` directly, you can trust the results :-D  
  
  
## Installation  
  
To install the library run the below command (This will also install ``requests``)  
  
* ``pip install google-currency``  
  
  
## Usage  
```  
from google_currency import convert  

# Converted without comma like 70000.00 
convert('usd', 'inr', 1000) 

# Converted amount with comma like 70,000.00
convert('usd', 'inr', 1000)
```  
  
This will return a JSON response like below  
  
```  
{  
	 "converted": true, 
	 "from": "USD", 
	 "to": "INR", 
	 "amount": "74876.00"
}

{  
	 "converted": true, 
	 "from": "USD", 
	 "to": "INR", 
	 "amount": "74,876.00"
}    
```  
  
  
## Response description  
  
* converted: Boolean indicating whether the amount is converted or not, if this is ``false`` than it means the  
currency code is not valid and the amount is not converted and it will be equal to ``0``.  
  
* amount: Converted amount  
  
* from: Currency code from which the amount is converted.  
* to: Currency code to which the amount is converted.

