itau-uy-api 0.1.0

A Python library for interacting with the Itau UY bank API

Itaú UY API

A Python library for interacting with the Itaú Uruguay bank API.

Installation

To install the package with all its dependencies:

pip install .

For development, install with all optional dependencies:

pip install ".[dev]"

If you want to install the package in editable mode for development:

pip install -e ".[dev]"

Usage

from itau_uy_api import ItauAPI
import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()

# Initialize the API
api = ItauAPI(os.environ['ITAU_USER_ID'], os.environ['ITAU_PASSWORD'])

# Login
api.login()

# Get account information
for account in api.accounts:
    print(f"Account Type: {account['type']}")
    print(f"Balance: {account['balance']} {account['currency']}")

# Get transactions for the current month
from datetime import datetime
current_month = datetime.now().month
current_year = datetime.now().year
transactions = api.get_month(api.accounts[0]['hash'], current_month, current_year)

# Get credit card transactions
credit_transactions = api.get_credit_card_transactions()

Development

To set up the development environment:

1. Clone the repository

2. Create a virtual environment: python -m venv .venv

3. Activate the virtual environment:

   • On Windows: .venv\Scripts\activate
   • On macOS and Linux: source .venv/bin/activate

4. Install dependencies: pip install ".[dev]"

5. Create a .env file in the root directory with the following content:

   ITAU_USER_ID=your_user_id
   ITAU_PASSWORD=your_password
   

   Replace your_user_id and your_password with your actual Itau credentials.

6. Run tests:

   pytest tests/
   

7. Run linters and formatters:

   black .
   pflake8
   mypy .
   

Note: Make sure to never commit your .env file to version control as it contains sensitive information.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch: git checkout -b feature/AmazingFeature
3. Commit your changes: git commit -m 'Add some AmazingFeature'
4. Push to the branch: git push origin feature/AmazingFeature
5. Open a pull request

License

This project is licensed under the MIT License. See the LICENSE file for details.