Metadata-Version: 2.1
Name: imfdatapy
Version: 0.1.1
Summary: A package for data discovery and extraction from the IMF!
License: Apache v2.0
Author: Irina Klein, Sou-Cheng T. Choi
Requires-Python: >=3.7,<4
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: numpy (>=1.23.5)
Requires-Dist: pandas (>=1.5.2)
Requires-Dist: requests (>=2.28.1)
Description-Content-Type: text/markdown

# imfdatapy

A package for data discovery and extraction from the International Monetary Fund (IMF)!
This repository contains Python source code and Jupyter notebooks with examples on how to extract data from the IMF.

TODO data license warning

## Installation

```bash
    $ pip install imfdatapy
```

## Usage

`imfdatapy` can be used to search through and extract data as follows. The examples below show how to search through the IFS (International Financial Statistics) and BOP (Balance of Payments) using ```serach_terms``` and download all the data with matching economic indicator names.

```python
from imfdatapy.imf import *
ifs = IFS(search_terms=["gross domestic product, real"], countries=["US"], period='Q',
start_date="2000", end_date="2022")
df = ifs.download_data()

bop = BOP(search_terms=["current account, total, credit"], countries=["US"], period='Q',
start_date="2000", end_date="2022")
df = bop.download_data()
```

## Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a [Code of Conduct](CONDUCT.md). By contributing to this project, you agree to abide by its terms.

## License

`imfdatapy` was created by Sou-Cheng T. Choi and Irina Klein, Illinois Institute of Technology. It is licensed under the terms of the Apache License, v2.0.

## Credits

`imfdatapy` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).
