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

Prerequisites
------------

Before installing AWS SSO Manager, ensure you have:

1. Python 3.9 or later installed
2. AWS CLI v2 installed and configured
3. An active AWS SSO configuration

Installing from PyPI
------------------

The easiest way to install AWS SSO Manager is via pip:

.. code-block:: bash

   pip install aws-sso-manager

Installing for Development
------------------------

To install AWS SSO Manager for development:

1. Clone the repository:

   .. code-block:: bash

      git clone https://github.com/jmfelice/aws_sso.git
      cd aws_sso

2. Create a virtual environment:

   .. code-block:: bash

      python -m venv venv
      source venv/bin/activate  # On Linux/Mac
      # Or on Windows:
      .\venv\Scripts\Activate.ps1  # On Windows PowerShell

3. Install development dependencies:

   .. code-block:: bash

      pip install -e ".[dev]"

System Requirements
-----------------

- Operating System: Windows, Linux, or macOS
- Python: 3.9 or later
- AWS CLI v2: Latest version recommended
- Disk Space: Minimal (~10MB for package and dependencies)
- Memory: Minimal (~50MB during operation)

AWS CLI Installation
------------------

The AWS CLI v2 is required and can be installed following the official AWS documentation:

- Windows: Download and run the MSI installer
- Linux: Use the package manager or run the install script
- macOS: Use homebrew or download the PKG installer

For detailed AWS CLI installation instructions, visit:
https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html