Add README.md and update version to 1.9.2 in setup.py and conf.py; enhance rate handling in converter.py

Author: ashwin31

README.md

@@ -0,0 +1,108 @@
+# forex-python
+
+[![travis-ci](https://travis-ci.org/MicroPyramid/forex-python.svg?branch=master)](https://travis-ci.org/MicroPyramid/forex-python)
+[![coveralls](https://coveralls.io/repos/github/MicroPyramid/forex-python/badge.svg?branch=master)](https://coveralls.io/github/MicroPyramid/forex-python?branch=master)
+[![Code Health](https://landscape.io/github/MicroPyramid/forex-python/master/landscape.svg?style=flat)](https://landscape.io/github/MicroPyramid/forex-python/master)
+[![pypi](https://img.shields.io/badge/python-3.6%2B-blue.svg)](https://pypi.python.org/pypi/forex-python)
+
+**Forex Python** is a free library for foreign exchange rates and currency conversion, supporting Python 3.6 and above.
+
+> **Note:** Install the latest version (`forex-python>=1.6`) to avoid `RatesNotAvailableError`.
+
+## Features
+
+- List all currency rates
+- Bitcoin price for all currencies
+- Convert amounts to and from Bitcoin
+- Get historical rates (since 1999)
+- Currency conversion (e.g., USD to INR)
+- Currency symbols and names
+
+## Currency Source
+
+[theratesapi.com](https://theratesapi.com) provides current and historical foreign exchange rates published by the European Central Bank. Rates are updated daily at 3PM CET.
+
+## Bitcoin Price Source
+
+Bitcoin prices are updated every minute. For more information, visit [CoinDesk](http://www.coindesk.com).
+
+## Installation
+
+Install via pip:
+```bash
+pip install forex-python
+```
+Or clone the repository and install manually:
+```bash
+git clone https://github.com/MicroPyramid/forex-python.git
+cd forex-python
+python3 setup.py install
+```
+
+## Usage Examples
+
+**Initialize the class:**
+```python
+from forex_python.converter import CurrencyRates
+c = CurrencyRates()
+```
+
+**List all latest currency rates for "USD":**
+```python
+c.get_rates('USD')
+# Example output: {'INR': 83.12, 'EUR': 0.92, ...}
+```
+
+**Get conversion rate from USD to INR:**
+```python
+c.get_rate('USD', 'INR')
+# Example output: 83.12
+```
+
+**Convert amount from USD to INR:**
+```python
+c.convert('USD', 'INR', 10)
+# Example output: 831.2
+```
+
+**Force use of Decimal:**
+```python
+from decimal import Decimal
+c = CurrencyRates(force_decimal=True)
+c.convert('USD', 'INR', Decimal('10.45'))
+# Example output: 868.75
+```
+
+**Get latest Bitcoin price:**
+```python
+from forex_python.bitcoin import BtcConverter
+b = BtcConverter()
+b.get_latest_price('USD')
+# Example output: 67000.0
+```
+
+**Convert amount to Bitcoins:**
+```python
+b.convert_to_btc(400, 'USD')
+# Example output: 0.00597
+```
+
+**Get currency symbol using currency code:**
+```python
+from forex_python.converter import CurrencyCodes
+codes = CurrencyCodes()
+codes.get_symbol('GBP')
+# Example output: '£'
+```
+
+For complete documentation, see the [forex-python docs](http://forex-python.readthedocs.org/en/latest/?badge=latest).
+
+---
+
+## Support & Feedback
+
+- Found a bug? Please [open a GitHub issue](https://github.com/MicroPyramid/forex-python/issues).
+- Need a new feature or custom development? [Contact us here](https://micropyramid.com/contact-us/).
+- Visit our [Python Development Services](https://micropyramid.com/python-development-services/) page for more information.
+
+---

README.rst

@@ -59,9 +59,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'1.9'
+version = u'1.9.2'
 # The full version, including alpha/beta/rc tags.
-release = u'1.9'
+release = u'1.9.2'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/source/conf.py

@@ -99,6 +99,9 @@ def convert(self, base_cur, dest_cur, amount, date_obj=None):
             if not rate:
                 raise RatesNotAvailableError("Currency {0} => {1} rate not available for Date {2}.".format(
                     source_url, dest_cur, date_str))
+            # Ensure rate is numeric
+            if isinstance(rate, str):
+                rate = Decimal(rate) if use_decimal else float(rate)
             try:
                 converted_amount = rate * amount
                 return converted_amount

forex_python/converter.py

@@ -3,7 +3,7 @@
 from setuptools import setup, find_packages
 
 # 1) Bump this version each release:
-VERSION = '1.9'
+VERSION = '1.9.2'
 
 # 2) Pull your README.md in as long_description:
 here = os.path.abspath(os.path.dirname(__file__))