mypackage-dev 0.1.0__tar.gz

mypackage_dev-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mypackage_dev-0.1.0/PKG-INFO

@@ -0,0 +1,330 @@
+Metadata-Version: 2.4
+Name: mypackage-dev
+Version: 0.1.0
+Summary: A sample Python package with semantic versioning for multiple environments (Development Environment)
+License: MIT
+License-File: LICENSE
+Keywords: sample,package,semantic-versioning
+Author: Your Name
+Author-email: your.email@example.com
+Requires-Python: >=3.8,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Project-URL: Documentation, https://github.com/yourusername/mypackage
+Project-URL: Homepage, https://github.com/yourusername/mypackage
+Project-URL: Repository, https://github.com/yourusername/mypackage
+Description-Content-Type: text/markdown
+
+# MyPackage
+
+A production-ready Python package demonstrating best practices for packaging, semantic versioning, and multi-environment publishing to PyPI.
+
+[![CI/CD](https://github.com/yourusername/mypackage/workflows/CI/badge.svg)](https://github.com/yourusername/mypackage/actions)
+[![PyPI version](https://badge.fury.io/py/mypackage.svg)](https://badge.fury.io/py/mypackage)
+[![Python versions](https://img.shields.io/pypi/pyversions/mypackage.svg)](https://pypi.org/project/mypackage/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+This package includes:
+- 🧮 **Calculator**: Basic arithmetic operations (add, subtract, multiply, divide)
+- 📝 **Text Utils**: String manipulation functions (capitalize, reverse, count words)
+- 📊 **Data Processor**: List and number processing utilities (filter, sum, statistics)
+
+## Multi-Environment Strategy
+
+This package supports three environments with the **same version number** across all:
+
+| Environment | Package Name | Purpose |
+|------------|--------------|---------|
+| **Production** | `mypackage` | Stable releases for production use |
+| **QA** | `mypackage-qa` | Testing and quality assurance |
+| **Development** | `mypackage-dev` | Latest development features |
+
+## Installation
+
+### Production Environment
+```bash
+pip install mypackage
+```
+
+### QA Environment
+```bash
+pip install mypackage-qa
+```
+
+### Development Environment
+```bash
+pip install mypackage-dev
+```
+
+## Quick Start
+
+```python
+from mypackage import add, subtract, capitalize_words, filter_even, get_statistics
+
+# Calculator functions
+result = add(10, 5)  # 15
+result = multiply(3, 4)  # 12
+
+# Text utilities
+text = capitalize_words("hello world")  # "Hello World"
+reversed_text = reverse_string("Python")  # "nohtyP"
+
+# Data processing
+evens = filter_even([1, 2, 3, 4, 5])  # [2, 4]
+stats = get_statistics([1, 2, 3, 4, 5])
+# {'min': 1, 'max': 5, 'mean': 3.0, 'sum': 15, 'count': 5}
+```
+
+## Development Setup
+
+### Prerequisites
+- Python 3.8 or higher
+- Poetry (for dependency management)
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/mypackage.git
+cd mypackage
+```
+
+2. Install dependencies using Poetry:
+```bash
+poetry install
+```
+
+3. Activate the virtual environment:
+```bash
+poetry shell
+```
+
+### Running Tests
+
+Run all tests with coverage:
+```bash
+poetry run pytest
+```
+
+Run specific test file:
+```bash
+poetry run pytest tests/test_calculator.py
+```
+
+### Code Quality
+
+Format code:
+```bash
+poetry run black src tests scripts
+poetry run isort src tests scripts
+```
+
+Run linting:
+```bash
+poetry run flake8 src tests
+```
+
+Type checking:
+```bash
+poetry run mypy src
+```
+
+Run all validations:
+```bash
+python scripts/validate.py
+```
+
+## Semantic Versioning
+
+This package follows [Semantic Versioning](https://semver.org/) (SemVer):
+- **MAJOR** version for incompatible API changes
+- **MINOR** version for backward-compatible functionality additions
+- **PATCH** version for backward-compatible bug fixes
+
+### Bumping Version
+
+Use the provided script to bump versions:
+
+```bash
+# Bump patch version (0.1.0 -> 0.1.1)
+python scripts/bump_version.py patch
+
+# Bump minor version (0.1.0 -> 0.2.0)
+python scripts/bump_version.py minor
+
+# Bump major version (0.1.0 -> 1.0.0)
+python scripts/bump_version.py major
+```
+
+The version will be automatically updated in:
+- `pyproject.toml`
+- `src/mypackage/__init__.py`
+- Git tag will be created
+
+## Publishing to PyPI
+
+### Prerequisites
+
+1. Create a PyPI account at [https://pypi.org](https://pypi.org)
+2. Generate an API token from your PyPI account settings
+3. Configure Poetry with your token:
+```bash
+poetry config pypi-token.pypi <your-token>
+```
+
+### Publishing Process
+
+1. **Validate your package**:
+```bash
+python scripts/validate.py
+```
+
+2. **Bump the version** (if needed):
+```bash
+python scripts/bump_version.py [major|minor|patch]
+```
+
+3. **Publish to specific environment**:
+```bash
+# Publish to dev
+python scripts/publish.py dev
+
+# Publish to qa
+python scripts/publish.py qa
+
+# Publish to prod
+python scripts/publish.py prod
+
+# Publish to all environments
+python scripts/publish.py all
+```
+
+4. **Dry run** (test without publishing):
+```bash
+python scripts/publish.py all --dry-run
+```
+
+### Version Consistency
+
+The same version number is maintained across all three environments (dev, qa, prod). Only the package name differs:
+- `mypackage-dev` version 0.1.0
+- `mypackage-qa` version 0.1.0
+- `mypackage` version 0.1.0
+
+## Project Structure
+
+```
+first_python_package/
+├── src/
+│   └── mypackage/
+│       ├── __init__.py
+│       ├── calculator.py
+│       ├── text_utils.py
+│       └── data_processor.py
+├── tests/
+│   ├── __init__.py
+│   ├── test_calculator.py
+│   ├── test_text_utils.py
+│   └── test_data_processor.py
+├── scripts/
+│   ├── bump_version.py
+│   ├── publish.py
+│   └── validate.py
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── pyproject.toml
+├── .bumpversion.cfg
+├── .gitignore
+├── .pre-commit-config.yaml
+├── LICENSE
+└── README.md
+```
+
+## API Documentation
+
+### Calculator Module
+
+- `add(a, b)` - Add two numbers
+- `subtract(a, b)` - Subtract b from a
+- `multiply(a, b)` - Multiply two numbers
+- `divide(a, b)` - Divide a by b (raises ValueError if b is zero)
+
+### Text Utils Module
+
+- `capitalize_words(text)` - Capitalize first letter of each word
+- `reverse_string(text)` - Reverse a string
+- `count_words(text)` - Count words in a string
+
+### Data Processor Module
+
+- `filter_even(numbers)` - Filter even numbers from a list
+- `sum_list(numbers)` - Calculate sum of numbers
+- `get_statistics(numbers)` - Get min, max, mean, sum, and count
+
+## CI/CD Pipeline
+
+The project includes a GitHub Actions workflow that:
+- Runs on Python 3.8, 3.9, 3.10, 3.11, and 3.12
+- Executes linting and type checking
+- Runs all tests with coverage reporting
+- Validates the package build
+- (Optional) Automatically publishes on version tags
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests and validation (`python scripts/validate.py`)
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to the branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+## Best Practices Implemented
+
+✅ **Poetry** for modern dependency management  
+✅ **Semantic Versioning** with automated version bumping  
+✅ **Multi-environment** support (dev, qa, prod)  
+✅ **Type hints** throughout the codebase  
+✅ **Comprehensive test suite** with pytest  
+✅ **Code quality tools** (black, isort, flake8, mypy)  
+✅ **Pre-commit hooks** for automated checks  
+✅ **CI/CD pipeline** with GitHub Actions  
+✅ **Detailed documentation** with examples  
+✅ **Proper package structure** following Python standards  
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and changes.
+
+## Support
+
+For issues and questions:
+- 🐛 [Report bugs](https://github.com/yourusername/mypackage/issues)
+- 💡 [Request features](https://github.com/yourusername/mypackage/issues)
+- 📧 Email: your.email@example.com
+
+## Acknowledgments
+
+This package was created as a demonstration of Python packaging best practices, including:
+- Multi-environment deployment strategy
+- Semantic versioning
+- Modern tooling with Poetry
+- Comprehensive testing and validation
+

mypackage_dev-0.1.0/README.md

@@ -0,0 +1,303 @@
+# MyPackage
+
+A production-ready Python package demonstrating best practices for packaging, semantic versioning, and multi-environment publishing to PyPI.
+
+[![CI/CD](https://github.com/yourusername/mypackage/workflows/CI/badge.svg)](https://github.com/yourusername/mypackage/actions)
+[![PyPI version](https://badge.fury.io/py/mypackage.svg)](https://badge.fury.io/py/mypackage)
+[![Python versions](https://img.shields.io/pypi/pyversions/mypackage.svg)](https://pypi.org/project/mypackage/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+This package includes:
+- 🧮 **Calculator**: Basic arithmetic operations (add, subtract, multiply, divide)
+- 📝 **Text Utils**: String manipulation functions (capitalize, reverse, count words)
+- 📊 **Data Processor**: List and number processing utilities (filter, sum, statistics)
+
+## Multi-Environment Strategy
+
+This package supports three environments with the **same version number** across all:
+
+| Environment | Package Name | Purpose |
+|------------|--------------|---------|
+| **Production** | `mypackage` | Stable releases for production use |
+| **QA** | `mypackage-qa` | Testing and quality assurance |
+| **Development** | `mypackage-dev` | Latest development features |
+
+## Installation
+
+### Production Environment
+```bash
+pip install mypackage
+```
+
+### QA Environment
+```bash
+pip install mypackage-qa
+```
+
+### Development Environment
+```bash
+pip install mypackage-dev
+```
+
+## Quick Start
+
+```python
+from mypackage import add, subtract, capitalize_words, filter_even, get_statistics
+
+# Calculator functions
+result = add(10, 5)  # 15
+result = multiply(3, 4)  # 12
+
+# Text utilities
+text = capitalize_words("hello world")  # "Hello World"
+reversed_text = reverse_string("Python")  # "nohtyP"
+
+# Data processing
+evens = filter_even([1, 2, 3, 4, 5])  # [2, 4]
+stats = get_statistics([1, 2, 3, 4, 5])
+# {'min': 1, 'max': 5, 'mean': 3.0, 'sum': 15, 'count': 5}
+```
+
+## Development Setup
+
+### Prerequisites
+- Python 3.8 or higher
+- Poetry (for dependency management)
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/mypackage.git
+cd mypackage
+```
+
+2. Install dependencies using Poetry:
+```bash
+poetry install
+```
+
+3. Activate the virtual environment:
+```bash
+poetry shell
+```
+
+### Running Tests
+
+Run all tests with coverage:
+```bash
+poetry run pytest
+```
+
+Run specific test file:
+```bash
+poetry run pytest tests/test_calculator.py
+```
+
+### Code Quality
+
+Format code:
+```bash
+poetry run black src tests scripts
+poetry run isort src tests scripts
+```
+
+Run linting:
+```bash
+poetry run flake8 src tests
+```
+
+Type checking:
+```bash
+poetry run mypy src
+```
+
+Run all validations:
+```bash
+python scripts/validate.py
+```
+
+## Semantic Versioning
+
+This package follows [Semantic Versioning](https://semver.org/) (SemVer):
+- **MAJOR** version for incompatible API changes
+- **MINOR** version for backward-compatible functionality additions
+- **PATCH** version for backward-compatible bug fixes
+
+### Bumping Version
+
+Use the provided script to bump versions:
+
+```bash
+# Bump patch version (0.1.0 -> 0.1.1)
+python scripts/bump_version.py patch
+
+# Bump minor version (0.1.0 -> 0.2.0)
+python scripts/bump_version.py minor
+
+# Bump major version (0.1.0 -> 1.0.0)
+python scripts/bump_version.py major
+```
+
+The version will be automatically updated in:
+- `pyproject.toml`
+- `src/mypackage/__init__.py`
+- Git tag will be created
+
+## Publishing to PyPI
+
+### Prerequisites
+
+1. Create a PyPI account at [https://pypi.org](https://pypi.org)
+2. Generate an API token from your PyPI account settings
+3. Configure Poetry with your token:
+```bash
+poetry config pypi-token.pypi <your-token>
+```
+
+### Publishing Process
+
+1. **Validate your package**:
+```bash
+python scripts/validate.py
+```
+
+2. **Bump the version** (if needed):
+```bash
+python scripts/bump_version.py [major|minor|patch]
+```
+
+3. **Publish to specific environment**:
+```bash
+# Publish to dev
+python scripts/publish.py dev
+
+# Publish to qa
+python scripts/publish.py qa
+
+# Publish to prod
+python scripts/publish.py prod
+
+# Publish to all environments
+python scripts/publish.py all
+```
+
+4. **Dry run** (test without publishing):
+```bash
+python scripts/publish.py all --dry-run
+```
+
+### Version Consistency
+
+The same version number is maintained across all three environments (dev, qa, prod). Only the package name differs:
+- `mypackage-dev` version 0.1.0
+- `mypackage-qa` version 0.1.0
+- `mypackage` version 0.1.0
+
+## Project Structure
+
+```
+first_python_package/
+├── src/
+│   └── mypackage/
+│       ├── __init__.py
+│       ├── calculator.py
+│       ├── text_utils.py
+│       └── data_processor.py
+├── tests/
+│   ├── __init__.py
+│   ├── test_calculator.py
+│   ├── test_text_utils.py
+│   └── test_data_processor.py
+├── scripts/
+│   ├── bump_version.py
+│   ├── publish.py
+│   └── validate.py
+├── .github/
+│   └── workflows/
+│       └── ci.yml
+├── pyproject.toml
+├── .bumpversion.cfg
+├── .gitignore
+├── .pre-commit-config.yaml
+├── LICENSE
+└── README.md
+```
+
+## API Documentation
+
+### Calculator Module
+
+- `add(a, b)` - Add two numbers
+- `subtract(a, b)` - Subtract b from a
+- `multiply(a, b)` - Multiply two numbers
+- `divide(a, b)` - Divide a by b (raises ValueError if b is zero)
+
+### Text Utils Module
+
+- `capitalize_words(text)` - Capitalize first letter of each word
+- `reverse_string(text)` - Reverse a string
+- `count_words(text)` - Count words in a string
+
+### Data Processor Module
+
+- `filter_even(numbers)` - Filter even numbers from a list
+- `sum_list(numbers)` - Calculate sum of numbers
+- `get_statistics(numbers)` - Get min, max, mean, sum, and count
+
+## CI/CD Pipeline
+
+The project includes a GitHub Actions workflow that:
+- Runs on Python 3.8, 3.9, 3.10, 3.11, and 3.12
+- Executes linting and type checking
+- Runs all tests with coverage reporting
+- Validates the package build
+- (Optional) Automatically publishes on version tags
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests and validation (`python scripts/validate.py`)
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to the branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+## Best Practices Implemented
+
+✅ **Poetry** for modern dependency management  
+✅ **Semantic Versioning** with automated version bumping  
+✅ **Multi-environment** support (dev, qa, prod)  
+✅ **Type hints** throughout the codebase  
+✅ **Comprehensive test suite** with pytest  
+✅ **Code quality tools** (black, isort, flake8, mypy)  
+✅ **Pre-commit hooks** for automated checks  
+✅ **CI/CD pipeline** with GitHub Actions  
+✅ **Detailed documentation** with examples  
+✅ **Proper package structure** following Python standards  
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and changes.
+
+## Support
+
+For issues and questions:
+- 🐛 [Report bugs](https://github.com/yourusername/mypackage/issues)
+- 💡 [Request features](https://github.com/yourusername/mypackage/issues)
+- 📧 Email: your.email@example.com
+
+## Acknowledgments
+
+This package was created as a demonstration of Python packaging best practices, including:
+- Multi-environment deployment strategy
+- Semantic versioning
+- Modern tooling with Poetry
+- Comprehensive testing and validation

mypackage_dev-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = [ "poetry-core",]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "mypackage-dev"
+version = "0.1.0"
+description = "A sample Python package with semantic versioning for multiple environments (Development Environment)"
+authors = [ "Your Name <your.email@example.com>",]
+readme = "README.md"
+license = "MIT"
+homepage = "https://github.com/yourusername/mypackage"
+repository = "https://github.com/yourusername/mypackage"
+documentation = "https://github.com/yourusername/mypackage"
+keywords = [ "sample", "package", "semantic-versioning",]
+classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12",]
+[[tool.poetry.packages]]
+include = "mypackage"
+from = "src"
+
+[tool.black]
+line-length = 88
+target-version = [ "py38",]
+include = "\\.pyi?$"
+
+[tool.isort]
+profile = "black"
+line_length = 88
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.poetry.dependencies]
+python = "^3.8"
+
+[tool.pytest.ini_options]
+testpaths = [ "tests",]
+python_files = "test_*.py"
+python_functions = "test_*"
+addopts = "-v --cov=mypackage --cov-report=term-missing --cov-report=html"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^7.4.0"
+pytest-cov = "^4.1.0"
+black = "^23.7.0"
+isort = "^5.12.0"
+flake8 = "^6.1.0"
+mypy = "^1.5.0"
+pre-commit = "^3.3.3"
+bump2version = "^1.0.1"

mypackage_dev-0.1.0/src/mypackage/__init__.py

@@ -0,0 +1,25 @@
+"""
+MyPackage - A sample Python package with semantic versioning.
+
+This package demonstrates best practices for creating and publishing
+Python packages to PyPI with support for multiple environments.
+"""
+
+__version__ = "0.1.0"
+
+from .calculator import add, subtract, multiply, divide
+from .text_utils import capitalize_words, reverse_string, count_words
+from .data_processor import filter_even, sum_list, get_statistics
+
+__all__ = [
+    "add",
+    "subtract",
+    "multiply",
+    "divide",
+    "capitalize_words",
+    "reverse_string",
+    "count_words",
+    "filter_even",
+    "sum_list",
+    "get_statistics",
+]

mypackage_dev-0.1.0/src/mypackage/calculator.py

@@ -0,0 +1,93 @@
+"""
+Calculator module providing basic arithmetic operations.
+"""
+
+from typing import Union
+
+
+Number = Union[int, float]
+
+
+def add(a: Number, b: Number) -> Number:
+    """
+    Add two numbers.
+
+    Args:
+        a: First number
+        b: Second number
+
+    Returns:
+        Sum of a and b
+
+    Example:
+        >>> add(2, 3)
+        5
+        >>> add(2.5, 3.5)
+        6.0
+    """
+    return a + b
+
+
+def subtract(a: Number, b: Number) -> Number:
+    """
+    Subtract second number from first number.
+
+    Args:
+        a: First number
+        b: Second number
+
+    Returns:
+        Difference of a and b
+
+    Example:
+        >>> subtract(5, 3)
+        2
+        >>> subtract(10.5, 3.5)
+        7.0
+    """
+    return a - b
+
+
+def multiply(a: Number, b: Number) -> Number:
+    """
+    Multiply two numbers.
+
+    Args:
+        a: First number
+        b: Second number
+
+    Returns:
+        Product of a and b
+
+    Example:
+        >>> multiply(2, 3)
+        6
+        >>> multiply(2.5, 4)
+        10.0
+    """
+    return a * b
+
+
+def divide(a: Number, b: Number) -> float:
+    """
+    Divide first number by second number.
+
+    Args:
+        a: Numerator
+        b: Denominator
+
+    Returns:
+        Quotient of a and b
+
+    Raises:
+        ValueError: If b is zero
+
+    Example:
+        >>> divide(6, 3)
+        2.0
+        >>> divide(10, 4)
+        2.5
+    """
+    if b == 0:
+        raise ValueError("Cannot divide by zero")
+    return a / b

mypackage_dev-0.1.0/src/mypackage/data_processor.py

@@ -0,0 +1,78 @@
+"""
+Data processing utilities for working with lists and numbers.
+"""
+
+from typing import List, Dict, Union
+
+
+Number = Union[int, float]
+
+
+def filter_even(numbers: List[int]) -> List[int]:
+    """
+    Filter even numbers from a list.
+
+    Args:
+        numbers: List of integers
+
+    Returns:
+        List containing only even numbers
+
+    Example:
+        >>> filter_even([1, 2, 3, 4, 5, 6])
+        [2, 4, 6]
+        >>> filter_even([1, 3, 5])
+        []
+    """
+    return [num for num in numbers if num % 2 == 0]
+
+
+def sum_list(numbers: List[Number]) -> Number:
+    """
+    Calculate the sum of numbers in a list.
+
+    Args:
+        numbers: List of numbers
+
+    Returns:
+        Sum of all numbers
+
+    Example:
+        >>> sum_list([1, 2, 3, 4, 5])
+        15
+        >>> sum_list([1.5, 2.5, 3.0])
+        7.0
+    """
+    return sum(numbers)
+
+
+def get_statistics(numbers: List[Number]) -> Dict[str, Number]:
+    """
+    Calculate basic statistics for a list of numbers.
+
+    Args:
+        numbers: List of numbers
+
+    Returns:
+        Dictionary containing min, max, mean, and sum
+
+    Raises:
+        ValueError: If the list is empty
+
+    Example:
+        >>> stats = get_statistics([1, 2, 3, 4, 5])
+        >>> stats['mean']
+        3.0
+        >>> stats['max']
+        5
+    """
+    if not numbers:
+        raise ValueError("Cannot calculate statistics for an empty list")
+
+    return {
+        "min": min(numbers),
+        "max": max(numbers),
+        "mean": sum(numbers) / len(numbers),
+        "sum": sum(numbers),
+        "count": len(numbers),
+    }

mypackage_dev-0.1.0/src/mypackage/py.typed

@@ -0,0 +1 @@
+# This file marks the package as PEP 561 compliant for type checking

mypackage_dev-0.1.0/src/mypackage/text_utils.py

@@ -0,0 +1,62 @@
+"""
+Text utility functions for string manipulation.
+"""
+
+
+def capitalize_words(text: str) -> str:
+    """
+    Capitalize the first letter of each word in a string.
+
+    Args:
+        text: Input string
+
+    Returns:
+        String with each word capitalized
+
+    Example:
+        >>> capitalize_words("hello world")
+        'Hello World'
+        >>> capitalize_words("python programming")
+        'Python Programming'
+    """
+    return text.title()
+
+
+def reverse_string(text: str) -> str:
+    """
+    Reverse a string.
+
+    Args:
+        text: Input string
+
+    Returns:
+        Reversed string
+
+    Example:
+        >>> reverse_string("hello")
+        'olleh'
+        >>> reverse_string("Python")
+        'nohtyP'
+    """
+    return text[::-1]
+
+
+def count_words(text: str) -> int:
+    """
+    Count the number of words in a string.
+
+    Args:
+        text: Input string
+
+    Returns:
+        Number of words in the string
+
+    Example:
+        >>> count_words("hello world")
+        2
+        >>> count_words("Python is awesome")
+        3
+    """
+    if not text or text.isspace():
+        return 0
+    return len(text.split())