# Publishing to PyPI

## Prerequisites

1. **PyPI Account**: Create an account at https://pypi.org/account/register/
2. **API Token** (Recommended): 
   - Go to https://pypi.org/manage/account/token/
   - Create a new API token with scope "Entire account" or just for this project
   - Save the token (starts with `pypi-`)

## Publishing Steps

### Option 1: Using API Token (Recommended)

```bash
# Upload to PyPI
twine upload dist/alexa_api-1.0.6*

# When prompted:
# Username: __token__
# Password: pypi-<your-api-token>
```

### Option 2: Using Username/Password

```bash
twine upload dist/alexa_api-1.0.6*
# Enter your PyPI username and password when prompted
```

### Option 3: Test PyPI First (Recommended for first-time publishing)

Test on Test PyPI first: https://test.pypi.org/

```bash
# Upload to Test PyPI
twine upload --repository testpypi dist/alexa_api-1.0.6*

# Test installation
pip install --index-url https://test.pypi.org/simple/ alexa-api
```

Then upload to production PyPI:

```bash
twine upload dist/alexa_api-1.0.6*
```

## After Publishing

Once published, users can install with:

```bash
pip install alexa-api
```

Your package will be available at: https://pypi.org/project/alexa-api/

## Notes

- Only upload the new version files (1.0.6), not old ones
- You can't overwrite a published version - you must increment the version
- The package name `alexa-api` is already registered to your account (based on README)

