aws-simple 0.1.0b0__tar.gz

aws_simple-0.1.0b0/.dockerignore

@@ -0,0 +1,63 @@
+# Git
+.git
+.gitignore
+.github
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Environment
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Documentation
+docs/
+*.md
+!README.md
+
+# Examples and tests
+examples/
+tests/
+
+# CI/CD
+.github/
+Makefile
+docker-compose.yml

aws_simple-0.1.0b0/.env.example

@@ -0,0 +1,24 @@
+# AWS Configuration for aws-simple library
+
+# Required: AWS Region
+AWS_REGION=us-east-1
+
+# Optional: AWS Profile (for local development with multiple profiles)
+# AWS_PROFILE=my-profile
+
+# Required: Default S3 bucket name
+AWS_S3_BUCKET=my-bucket-name
+
+# Optional: Textract-specific region (defaults to AWS_REGION)
+# AWS_TEXTRACT_REGION=us-east-1
+
+# Optional: Bedrock model ID (defaults to Claude 3.5 Sonnet)
+# AWS_BEDROCK_MODEL_ID=anthropic.claude-3-5-sonnet-20241022-v2:0
+
+# Optional: Bedrock-specific region (defaults to AWS_REGION)
+# AWS_BEDROCK_REGION=us-east-1
+
+# Note: AWS credentials should be configured separately via:
+# - IAM Role (recommended for production/EC2/ECS/Lambda)
+# - ~/.aws/credentials file (for local development)
+# - AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY env vars (not recommended)

aws_simple-0.1.0b0/.github/workflows/ci.yml

@@ -0,0 +1,111 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12","3.13","3.14"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Cache pip packages
+      uses: actions/cache@v4
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run tests with coverage
+      run: |
+        pytest tests/ -v --cov=aws_simple --cov-report=xml --cov-report=term
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false
+
+  lint:
+    name: Lint and Type Check
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run Black formatter check
+      run: |
+        black --check src/ tests/
+
+    - name: Run Ruff linter
+      run: |
+        ruff check src/
+
+    - name: Run mypy type checker
+      run: |
+        mypy src/
+      continue-on-error: true
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build package
+      run: |
+        python -m build
+
+    - name: Check package
+      run: |
+        twine check dist/*
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist-packages
+        path: dist/
+        retention-days: 7

aws_simple-0.1.0b0/.github/workflows/publish.yml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Publish to TestPyPI or PyPI'
+        required: true
+        default: 'testpypi'
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+jobs:
+  build-and-publish:
+    name: Build and Publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: ${{ github.event.inputs.environment || 'pypi' }}
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build package
+      run: |
+        python -m build
+
+    - name: Check package
+      run: |
+        twine check dist/*
+
+    - name: Publish to Test PyPI
+      if: github.event.inputs.environment == 'testpypi'
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+        password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+        skip-existing: true
+
+    - name: Publish to PyPI
+      if: github.event_name == 'release' || github.event.inputs.environment == 'pypi'
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}

aws_simple-0.1.0b0/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

aws_simple-0.1.0b0/.pre-commit-config.yaml

@@ -0,0 +1,38 @@
+# Pre-commit hooks configuration
+# Install: pip install pre-commit && pre-commit install
+# Run manually: pre-commit run --all-files
+
+repos:
+  - repo: https://github.com/psf/black
+    rev: 25.12.0
+    hooks:
+      - id: black
+        language_version: python3.10
+        args: [--line-length=100]
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=1000]
+      - id: check-merge-conflict
+      - id: check-json
+      - id: pretty-format-json
+        args: [--autofix, --no-sort-keys]
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.19.1
+    hooks:
+      - id: mypy
+        additional_dependencies: [boto3-stubs, types-python-dotenv]
+        args: [--strict]

aws_simple-0.1.0b0/CONTRIBUTING.md

@@ -0,0 +1,220 @@
+# Contributing to aws-simple
+
+Thank you for your interest in contributing to aws-simple!
+
+## Development Setup
+
+### Prerequisites
+- Python ≥ 3.10
+- pip
+- git
+
+### Setup Development Environment
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/aws-toolkit-py.git
+cd aws-toolkit-py
+```
+
+2. Create a virtual environment:
+```bash
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+```
+
+3. Install development dependencies:
+```bash
+pip install -e ".[dev]"
+```
+
+4. Configure environment variables:
+```bash
+cp .env.example .env
+# Edit .env with your AWS configuration
+```
+
+## Development Workflow
+
+### Running Tests
+
+Run all tests:
+```bash
+make test
+# or
+pytest tests/
+```
+
+Run tests with coverage:
+```bash
+make test-cov
+# or
+pytest tests/ --cov=aws_simple --cov-report=html
+```
+
+### Code Quality
+
+Run linter:
+```bash
+make lint
+# or
+ruff check src/
+```
+
+Format code:
+```bash
+make format
+# or
+ruff format src/ tests/
+```
+
+Type checking:
+```bash
+make type-check
+# or
+mypy src/
+```
+
+### Building the Package
+
+Build distribution files:
+```bash
+make build
+# or
+python -m build
+```
+
+Check package:
+```bash
+twine check dist/*
+```
+
+## CI/CD Pipeline
+
+### Continuous Integration
+
+The CI pipeline runs on every push and pull request:
+
+1. **Tests** - Run on Python 3.10, 3.11, 3.12
+2. **Linting** - Ruff checks code quality
+3. **Type Checking** - mypy validates types
+4. **Build** - Builds wheel and sdist packages
+
+See [.github/workflows/ci.yml](.github/workflows/ci.yml)
+
+### Publishing
+
+#### Test PyPI (Manual)
+
+Publish to Test PyPI for testing:
+```bash
+make publish-test
+```
+
+Or via GitHub Actions:
+1. Go to Actions → Publish to PyPI
+2. Run workflow → Select "testpypi"
+
+#### PyPI (Automated)
+
+Publishing to PyPI happens automatically on release:
+
+1. Create a new release on GitHub
+2. Tag format: `v0.1.0`
+3. CI/CD automatically builds and publishes
+
+See [.github/workflows/publish.yml](.github/workflows/publish.yml)
+
+### Docker
+
+Build Docker image:
+```bash
+docker build -t aws-simple:latest .
+```
+
+Run with docker-compose:
+```bash
+# Configure .env file first
+docker-compose up
+```
+
+## Making Changes
+
+### Branch Strategy
+
+- `main` - Production-ready code
+- `develop` - Development branch
+- Feature branches: `feature/your-feature-name`
+- Bug fixes: `fix/bug-description`
+
+### Commit Messages
+
+Follow conventional commits:
+- `feat:` - New feature
+- `fix:` - Bug fix
+- `docs:` - Documentation changes
+- `test:` - Test changes
+- `refactor:` - Code refactoring
+- `chore:` - Maintenance tasks
+
+Example:
+```
+feat: add support for S3 presigned URLs
+fix: handle empty Textract responses
+docs: update installation instructions
+```
+
+### Pull Request Process
+
+1. Create a feature branch
+2. Make your changes
+3. Add/update tests
+4. Ensure all tests pass
+5. Update documentation if needed
+6. Submit pull request to `develop` branch
+
+## Code Guidelines
+
+### Python Style
+
+- Follow PEP 8
+- Use type hints
+- Maximum line length: 100 characters
+- Use ruff for formatting
+
+### Testing
+
+- Write tests for all new features
+- Maintain >90% code coverage
+- Use descriptive test names
+- Mock external AWS calls
+
+### Documentation
+
+- Update README.md for user-facing changes
+- Add docstrings to all public functions
+- Include examples for new features
+
+## Project Structure
+
+```
+aws-toolkit-py/
+├── src/aws_simple/       # Source code
+│   ├── __init__.py       # Public API
+│   ├── config.py         # Configuration
+│   ├── s3.py             # S3 module
+│   ├── textract.py       # Textract module
+│   ├── bedrock.py        # Bedrock module
+│   ├── _clients.py       # Internal AWS clients
+│   ├── exceptions.py     # Custom exceptions
+│   ├── models/           # Data models
+│   └── _parsers/         # Internal parsers
+├── tests/                # Test suite
+├── examples/             # Usage examples
+├── .github/workflows/    # CI/CD workflows
+└── docs/                 # Documentation
+```
+
+## Questions?
+
+Open an issue on GitHub for questions or discussions.