Installation
============

Requirements
------------

- Python 3.8 or higher
- pip package manager

PyPI Installation
-----------------

.. code-block:: bash

   pip install xfinance-python-sdk

Installation from Source
------------------------

.. code-block:: bash

   git clone https://github.com/martourez21/xfinance-python-sdk.git
   cd xfinance-python-sdk
   pip install -e .

Optional Dependencies
---------------------

For development and additional features:

.. code-block:: bash

   # Development tools
   pip install "xfinance-python-sdk[dev]"

   # Documentation tools
   pip install "xfinance-python-sdk[docs]"

   # Async support
   pip install "xfinance-python-sdk[async]"

Environment Variables
---------------------

The SDK can be configured using environment variables:

.. code-block:: bash

   export XFINANCE_API_KEY="your-api-key"
   export XFINANCE_API_SECRET="your-api-secret"
   export XFINANCE_API_URL="https://api.xfinance.com"
   export XFINANCE_TIMEOUT=30
   export XFINANCE_MAX_RETRIES=3

Verification
------------

Verify installation by importing the package:

.. code-block:: python

   python -c "from xfinance_sdk import XFinanceClient; print('SDK imported successfully')"