mypackage-dev 0.1.1__tar.gz → 0.2.1.dev0__tar.gz

{mypackage_dev-0.1.1 → mypackage_dev-0.2.1.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mypackage-dev
-Version: 0.1.1
+Version: 0.2.1.dev0
 Summary: A sample Python package with semantic versioning for multiple environments (Development Environment)
 License: MIT
 License-File: LICENSE
@@ -282,6 +282,31 @@ The project includes a GitHub Actions workflow that:
 - Validates the package build
 - (Optional) Automatically publishes on version tags
 
+## Documentation
+
+Comprehensive guides are available for all aspects of this project:
+
+### Getting Started
+- [QUICKSTART.md](QUICKSTART.md) - Quick setup and first steps
+- [SETUP.md](SETUP.md) - Detailed development environment setup
+
+### Development Workflow
+- [VERSION_MANAGEMENT.md](VERSION_MANAGEMENT.md) - **Comprehensive version bumping guide** 🆕
+- [PRE_RELEASE_VERSIONING.md](PRE_RELEASE_VERSIONING.md) - **Pre-release & development versioning (dev, alpha, beta, RC)** 🆕
+- [PRE_RELEASE_QUICK_START.md](PRE_RELEASE_QUICK_START.md) - **Quick start for pre-release versions** 🆕
+- [BRANCHING_STRATEGY.md](BRANCHING_STRATEGY.md) - Git workflow and branch management
+- [RELEASE_NOTES_GUIDE.md](RELEASE_NOTES_GUIDE.md) - Conventional commits and automated release notes
+
+### Deployment & Publishing
+- [PUBLISHING.md](PUBLISHING.md) - PyPI publishing process
+- [CI_CD_SETUP_GUIDE.md](CI_CD_SETUP_GUIDE.md) - GitHub Actions pipeline setup
+- [GITHUB_ENVIRONMENTS_SETUP.md](GITHUB_ENVIRONMENTS_SETUP.md) - Environment protection rules
+- [QUICK_DEPLOYMENT_GUIDE.md](QUICK_DEPLOYMENT_GUIDE.md) - Fast deployment reference
+
+### Architecture & Design
+- [PROJECT_OVERVIEW.md](PROJECT_OVERVIEW.md) - High-level project structure
+- [PIPELINE_ARCHITECTURE.md](PIPELINE_ARCHITECTURE.md) - CI/CD pipeline details
+
 ## Contributing
 
 1. Fork the repository

{mypackage_dev-0.1.1 → mypackage_dev-0.2.1.dev0}/README.md

@@ -256,6 +256,31 @@ The project includes a GitHub Actions workflow that:
 - Validates the package build
 - (Optional) Automatically publishes on version tags
 
+## Documentation
+
+Comprehensive guides are available for all aspects of this project:
+
+### Getting Started
+- [QUICKSTART.md](QUICKSTART.md) - Quick setup and first steps
+- [SETUP.md](SETUP.md) - Detailed development environment setup
+
+### Development Workflow
+- [VERSION_MANAGEMENT.md](VERSION_MANAGEMENT.md) - **Comprehensive version bumping guide** 🆕
+- [PRE_RELEASE_VERSIONING.md](PRE_RELEASE_VERSIONING.md) - **Pre-release & development versioning (dev, alpha, beta, RC)** 🆕
+- [PRE_RELEASE_QUICK_START.md](PRE_RELEASE_QUICK_START.md) - **Quick start for pre-release versions** 🆕
+- [BRANCHING_STRATEGY.md](BRANCHING_STRATEGY.md) - Git workflow and branch management
+- [RELEASE_NOTES_GUIDE.md](RELEASE_NOTES_GUIDE.md) - Conventional commits and automated release notes
+
+### Deployment & Publishing
+- [PUBLISHING.md](PUBLISHING.md) - PyPI publishing process
+- [CI_CD_SETUP_GUIDE.md](CI_CD_SETUP_GUIDE.md) - GitHub Actions pipeline setup
+- [GITHUB_ENVIRONMENTS_SETUP.md](GITHUB_ENVIRONMENTS_SETUP.md) - Environment protection rules
+- [QUICK_DEPLOYMENT_GUIDE.md](QUICK_DEPLOYMENT_GUIDE.md) - Fast deployment reference
+
+### Architecture & Design
+- [PROJECT_OVERVIEW.md](PROJECT_OVERVIEW.md) - High-level project structure
+- [PIPELINE_ARCHITECTURE.md](PIPELINE_ARCHITECTURE.md) - CI/CD pipeline details
+
 ## Contributing
 
 1. Fork the repository

{mypackage_dev-0.1.1 → mypackage_dev-0.2.1.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "mypackage-dev"
-version = "0.1.1"
+version = "0.2.1.dev0"
 description = "A sample Python package with semantic versioning for multiple environments (Development Environment)"
 authors = [ "Your Name <your.email@example.com>",]
 readme = "README.md"

mypackage_dev-0.2.1.dev0/src/mypackage/__init__.py

@@ -0,0 +1,43 @@
+"""
+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.2.1.dev0"
+
+from .calculator import add, divide, modulo, multiply, power, subtract
+from .data_processor import (
+    filter_even,
+    find_median,
+    get_statistics,
+    remove_duplicates,
+    sum_list,
+)
+from .text_utils import (
+    capitalize_words,
+    count_words,
+    is_palindrome,
+    remove_whitespace,
+    reverse_string,
+)
+
+__all__ = [
+    "add",
+    "subtract",
+    "multiply",
+    "divide",
+    "power",
+    "modulo",
+    "capitalize_words",
+    "reverse_string",
+    "count_words",
+    "is_palindrome",
+    "remove_whitespace",
+    "filter_even",
+    "sum_list",
+    "get_statistics",
+    "find_median",
+    "remove_duplicates",
+]

{mypackage_dev-0.1.1 → mypackage_dev-0.2.1.dev0}/src/mypackage/calculator.py

@@ -90,3 +90,52 @@ def divide(a: Number, b: Number) -> float:
     if b == 0:
         raise ValueError("Cannot divide by zero")
     return a / b
+
+
+def power(base: Number, exponent: Number) -> Number:
+    """
+    Raise base to the power of exponent.
+
+    Args:
+        base: Base number
+        exponent: Exponent
+
+    Returns:
+        Result of base raised to exponent
+
+    Example:
+        >>> power(2, 3)
+        8
+        >>> power(5, 2)
+        25
+        >>> power(2.5, 2)
+        6.25
+    """
+    return base**exponent
+
+
+def modulo(a: int, b: int) -> int:
+    """
+    Calculate the modulo (remainder) of a divided by b.
+
+    Args:
+        a: Dividend
+        b: Divisor
+
+    Returns:
+        Remainder of a divided by b
+
+    Raises:
+        ValueError: If b is zero
+
+    Example:
+        >>> modulo(10, 3)
+        1
+        >>> modulo(15, 4)
+        3
+        >>> modulo(8, 2)
+        0
+    """
+    if b == 0:
+        raise ValueError("Cannot perform modulo with zero")
+    return a % b

{mypackage_dev-0.1.1 → mypackage_dev-0.2.1.dev0}/src/mypackage/data_processor.py

@@ -75,3 +75,65 @@ def get_statistics(numbers: List[Number]) -> Dict[str, Number]:
         "sum": sum(numbers),
         "count": len(numbers),
     }
+
+
+def find_median(numbers: List[Number]) -> float:
+    """
+    Find the median value in a list of numbers.
+
+    Args:
+        numbers: List of numbers
+
+    Returns:
+        Median value
+
+    Raises:
+        ValueError: If the list is empty
+
+    Example:
+        >>> find_median([1, 2, 3, 4, 5])
+        3.0
+        >>> find_median([1, 2, 3, 4])
+        2.5
+        >>> find_median([5, 1, 3, 2, 4])
+        3.0
+    """
+    if not numbers:
+        raise ValueError("Cannot find median of an empty list")
+
+    sorted_numbers = sorted(numbers)
+    n = len(sorted_numbers)
+
+    if n % 2 == 0:
+        # Even number of elements: average of middle two
+        return (sorted_numbers[n // 2 - 1] + sorted_numbers[n // 2]) / 2
+    else:
+        # Odd number of elements: middle element
+        return float(sorted_numbers[n // 2])
+
+
+def remove_duplicates(items: List) -> List:
+    """
+    Remove duplicate items from a list while preserving order.
+
+    Args:
+        items: List of items (can be any hashable type)
+
+    Returns:
+        List with duplicates removed
+
+    Example:
+        >>> remove_duplicates([1, 2, 2, 3, 3, 3, 4])
+        [1, 2, 3, 4]
+        >>> remove_duplicates(['a', 'b', 'a', 'c', 'b'])
+        ['a', 'b', 'c']
+        >>> remove_duplicates([])
+        []
+    """
+    seen = set()
+    result = []
+    for item in items:
+        if item not in seen:
+            seen.add(item)
+            result.append(item)
+    return result

{mypackage_dev-0.1.1 → mypackage_dev-0.2.1.dev0}/src/mypackage/text_utils.py

@@ -60,3 +60,45 @@ def count_words(text: str) -> int:
     if not text or text.isspace():
         return 0
     return len(text.split())
+
+
+def is_palindrome(text: str) -> bool:
+    """
+    Check if a string is a palindrome (reads the same forwards and backwards).
+
+    Args:
+        text: Input string
+
+    Returns:
+        True if the string is a palindrome, False otherwise
+
+    Example:
+        >>> is_palindrome("racecar")
+        True
+        >>> is_palindrome("hello")
+        False
+        >>> is_palindrome("A man a plan a canal Panama")
+        True
+    """
+    # Remove spaces and convert to lowercase for comparison
+    cleaned = "".join(text.split()).lower()
+    return cleaned == cleaned[::-1]
+
+
+def remove_whitespace(text: str) -> str:
+    """
+    Remove all whitespace characters from a string.
+
+    Args:
+        text: Input string
+
+    Returns:
+        String with all whitespace removed
+
+    Example:
+        >>> remove_whitespace("hello world")
+        'helloworld'
+        >>> remove_whitespace("  Python   Programming  ")
+        'PythonProgramming'
+    """
+    return "".join(text.split())

mypackage_dev-0.1.1/src/mypackage/__init__.py

@@ -1,25 +0,0 @@
-"""
-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, divide, multiply, subtract
-from .data_processor import filter_even, get_statistics, sum_list
-from .text_utils import capitalize_words, count_words, reverse_string
-
-__all__ = [
-    "add",
-    "subtract",
-    "multiply",
-    "divide",
-    "capitalize_words",
-    "reverse_string",
-    "count_words",
-    "filter_even",
-    "sum_list",
-    "get_statistics",
-]