semvec/pypi-packages huggingface dataset:
HBV 1.5.2
Dev version for a HBV hydrological model using BMI for eWaterCycle.

# HBV-BMI

[![PyPI](https://img.shields.io/pypi/v/HBV)](https://pypi.org/project/HBV/)

Basic Model Interface (BMI) HBV model intended for use with [eWaterCycle](https://github.com/eWaterCycle). See said repo for installation instructions. 

HBV (Hydrologiska Byråns Vattenbalansavdelning) is a conceptual hydrological model. For more information on its history, see this [paper](https://hess.copernicus.org/articles/26/1371/2022/).

_TODO: update to match snow reservoir_

This current implementation is _without_ a snow reservoir, as shown below.
(_Image from the course ENVM1502 - river basin Hydrology (Markus Hrachowitz)._) 
![model_layout.png](https://raw.githubusercontent.com/Daafip/HBV-bmi/main/docs/model_layout.png)

Actual eWatercycle model wrapper can be found on [GitHub](https://github.com/Daafip/ewatercycle-hbv) with accompanying [documentation](https://ewatercycle-hbv.readthedocs.io/en/latest/)

Feel free to fork/duplicate this repo and publish your own (better) version.


## separate use
Can also be used as a standalone package _in theory_ - not advised:

```console
pip install HBV
```

Then HBV becomes available as one of the eWaterCycle models

```python
from HBV import HBV

model = HBV()
```

Be aware of the non-intuitive [BMI](https://github.com/eWaterCycle/grpc4bmi) implementation as this package is designed to run in a [docker](https://github.com/Daafip/HBV-bmi/pkgs/container/hbv-bmi-grpc4bmi) container. 


## Changelog

See [CHANGELOG.md](https://github.com/Daafip/HBV-bmi/blob/main/CHANGELOD.md).
moneymatters 2024.5.3
A Python package that encompasses money related stuff into one package - money formatting, currency conversion etc

# MoneyMatters

MoneyMatters is a Python package designed to simplify several common monetary operations, such as currency conversion and money formatting. It integrates functionalities from multiple sources to provide a unified solution for handling monetary values, leveraging real-time data for accurate currency conversions and providing various formatting options.

## Features

- **Currency Conversion**: Convert amounts from one currency to another using real-time exchange rates.
- **Money Formatting**: Format monetary values into a more readable form or according to specific cultural norms.

## Installation

To install MoneyMatters, run the following command:

```bash
pip install moneymatters
```

Ensure you have Python 3.7 or later installed on your system.

## Usage

### Currency Conversion

To convert currency, use the `ExchangeAPI` class:

```python
from moneymatters.api import ExchangeAPI

# Create an instance of the ExchangeAPI
converter = ExchangeAPI()

# Convert 100 USD to EUR
converted_amount = converter.convert(100, 'USD', 'EUR')
print(f"100 USD is equivalent to {converted_amount} EUR")
```

### Money Formatting

To format money values, use the `Formatter` class:

```python
from moneymatters.api import Formatter

# Format a price in a specific pattern
formatted_price = Formatter.apply_price_format(1234.56, '99.99')
print(f"The formatted price is {formatted_price}")
```

## Additional Information

- **API Sources**:
  - ECB for major 30 currencies.
  - Fawaz Ahmed's exchange-api for 150+ currencies.
  - XE.com for detailed and possibly more accurate data as a last resort.

## Contributing

Contributions are welcome! For major changes, please open an issue first to discuss what you would like to change. Ensure to update tests as appropriate.

## License

This project is licensed under the Affero GNU Public License v3 - see the [LICENSE](LICENSE) file for details.

## Contact

- **Author**: Gopala Krishna Koduri
- **Email**: [gopal@riyazapp.com](mailto:gopal@riyazapp.com)
- [GitHub Repository](https://github.com/musicmuni/moneymatters)
- [Issue Tracker](https://github.com/musicmuni/moneymatters/issues)
- [LinkedIn](https://linkedin.com/in/gopalkoduri)
- [Learn to Sing with Riyaz App](https://riyazapp.com)

## Acknowledgments

Thanks to all contributors who have helped shape MoneyMatters, making it easier to deal with currency related stuff for developers around the globe.