winipedia-utils 0.2.17__py3-none-any.whl → 0.2.22__py3-none-any.whl

winipedia_utils/git/workflows/__init__.py

@@ -0,0 +1 @@
+"""__init__ module for winipedia_utils.git.workflows."""

winipedia_utils/git/workflows/publish.py

@@ -0,0 +1,76 @@
+"""Contains the publish workflow.
+
+This workflow is used to publish the package to PyPI with poetry.
+"""
+
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+PUBLISH_WORKFLOW_PATH = Path(".github/workflows/publish.yaml")
+
+
+def load_publish_workflow() -> dict[str, Any]:
+    """Load the publish workflow."""
+    path = PUBLISH_WORKFLOW_PATH
+    if not path.exists():
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.touch()
+    return yaml.safe_load(path.read_text()) or {}
+
+
+def dump_publish_workflow(config: dict[str, Any]) -> None:
+    """Dump the publish workflow."""
+    path = PUBLISH_WORKFLOW_PATH
+    with path.open("w") as f:
+        yaml.safe_dump(config, f, sort_keys=False)
+
+
+def _get_publish_config() -> dict[str, Any]:
+    """Dict that represents the publish workflow yaml."""
+    return {
+        "name": "Publish to PyPI",
+        "on": {"release": {"types": ["published"]}},
+        "jobs": {
+            "publish": {
+                "runs-on": "ubuntu-latest",
+                "steps": [
+                    {"name": "Checkout repository", "uses": "actions/checkout@v4"},
+                    {
+                        "name": "Set up Python",
+                        "uses": "actions/setup-python@v5",
+                        "with": {"python-version": "3.x"},
+                    },
+                    {"name": "Install Poetry", "run": "pip install poetry"},
+                    {
+                        "name": "Configure Poetry",
+                        "run": "poetry config pypi-token.pypi ${{ secrets.PYPI_TOKEN }}",  # noqa: E501
+                    },
+                    {
+                        "name": "Build and publish to PyPI",
+                        "run": "poetry publish --build",
+                    },
+                ],
+            }
+        },
+    }
+
+
+def _publish_config_is_correct() -> bool:
+    """Check if the publish workflow is correct."""
+    config = load_publish_workflow()
+    return bool(config == _get_publish_config())
+
+
+def _add_publish_workflow() -> None:
+    """Add the publish workflow.
+
+    If you delete the .github/workflows/publish.yaml file, then the tests will not fail.
+    Not all projects need publishing to pypi. It is added on setup, but if you remove
+    the file, then the tests will not fail and the tests will assume you don't want it.
+    """
+    if _publish_config_is_correct():
+        return
+    config = _get_publish_config()
+    dump_publish_workflow(config)

winipedia_utils/setup.py

@@ -6,12 +6,16 @@ This package assumes you are using poetry and pre-commit.
 This script is intended to be called once at the beginning of a project.
 """
 
+from collections.abc import Callable
+from typing import Any
+
 from winipedia_utils.git.gitignore.gitignore import _add_package_patterns_to_gitignore
 from winipedia_utils.git.pre_commit.config import (
     _add_package_hook_to_pre_commit_config,
     _pre_commit_install,
 )
 from winipedia_utils.git.pre_commit.run_hooks import _run_all_hooks
+from winipedia_utils.git.workflows.publish import _add_publish_workflow
 from winipedia_utils.logging.logger import get_logger
 from winipedia_utils.projects.poetry.config import (
     _add_configurations_to_pyproject_toml,
@@ -24,22 +28,28 @@ from winipedia_utils.projects.project import _create_project_root
 logger = get_logger(__name__)
 
 
+SETUP_STEPS = [
+    _install_dev_dependencies,
+    _add_package_hook_to_pre_commit_config,
+    _pre_commit_install,
+    _add_package_patterns_to_gitignore,
+    _add_publish_workflow,
+    _add_configurations_to_pyproject_toml,
+    _create_project_root,
+    _run_all_hooks,
+]
+
+
+def _get_setup_steps() -> list[Callable[..., Any]]:
+    """Get the setup steps."""
+    return SETUP_STEPS
+
+
 def _setup() -> None:
     """Set up the project."""
-    # install winipedia_utils dev dependencies as dev
-    _install_dev_dependencies()
-    # create pre-commit config
-    _add_package_hook_to_pre_commit_config()
-    # install pre-commit
-    _pre_commit_install()
-    # add patterns to .gitignore
-    _add_package_patterns_to_gitignore()
-    # add tool.* configurations to pyproject.toml
-    _add_configurations_to_pyproject_toml()
-    # create the project root
-    _create_project_root()
-    # run pre-commit once, create tests is included here
-    _run_all_hooks()
+    for step in _get_setup_steps():
+        logger.info("Running setup step: %s", step.__name__)
+        step()
     logger.info("Setup complete!")
 
 

winipedia_utils/testing/tests/base/fixtures/scopes/session.py

@@ -14,6 +14,10 @@ from winipedia_utils.git.gitignore.gitignore import _gitignore_is_correct
 from winipedia_utils.git.pre_commit.config import (
     _pre_commit_config_is_correct,
 )
+from winipedia_utils.git.workflows.publish import (
+    PUBLISH_WORKFLOW_PATH,
+    _publish_config_is_correct,
+)
 from winipedia_utils.modules.module import to_path
 from winipedia_utils.modules.package import (
     find_packages,
@@ -164,6 +168,22 @@ def _test_gitignore_is_correct() -> None:
     )
 
 
+@autouse_session_fixture
+def _test_publish_workflow_is_correct() -> None:
+    """Verify that the publish workflow is correctly defined.
+
+    If the file does not exist, we skip this test bc not all projects necessarily
+    need to publish to pypi, e.g. they are binaries or private usage only or for profit.
+    """
+    path = PUBLISH_WORKFLOW_PATH
+    if not path.exists():
+        return
+    assert_with_msg(
+        _publish_config_is_correct(),
+        "Publish workflow is not correct.",
+    )
+
+
 @autouse_session_fixture
 def _test_no_namespace_packages() -> None:
     """Verify that there are no namespace packages in the project.

{winipedia_utils-0.2.17.dist-info → winipedia_utils-0.2.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: winipedia-utils
-Version: 0.2.17
+Version: 0.2.22
 Summary: A package with many utility functions
 License-Expression: MIT
 License-File: LICENSE
@@ -126,10 +126,16 @@ Adds tool configurations in pyproject.toml for e.g.:
 - **pytest** - Test discovery and execution
 - **bandit** - Security scanning
 
-### Step 6️⃣ - Create Project Root
+### Step 6️⃣ - Create GitHub Actions Workflow
+Sets up `.github/workflows/publish.yaml` for automated PyPI publishing:
+- Triggers on GitHub releases
+- Configures Poetry with PyPI token
+- Builds and publishes package automatically
+
+### Step 7️⃣ - Create Project Root
 Creates your project's root package directory with `py.typed` marker for type hint support.
 
-### Step 7️⃣ - Run Pre-commit Hook
+### Step 8️⃣ - Run Pre-commit Hook
 Executes the complete quality pipeline (see below).
 
 ---
@@ -137,7 +143,6 @@ Executes the complete quality pipeline (see below).
 ## Pre-commit Hook Workflow
 
 When you commit code, the winipedia-utils hook automatically runs a few quality checks e.g.:
-
 ```
 ┌─────────────────────────────────────────────────────────┐
 │         Pre-commit Hook Execution Pipeline              │
@@ -285,9 +290,9 @@ print(data.df)  # Cleaned and validated dataframe
 
 ### 3. 🔧 Git Utilities
 
-Manage gitignore patterns and pre-commit configuration.
+Manage gitignore patterns, pre-commit configuration, and GitHub Actions workflows.
 
-**Use Cases:** Project setup, git workflow automation
+**Use Cases:** Project setup, git workflow automation, CI/CD pipeline setup
 
 ```python
 from winipedia_utils.git.gitignore.gitignore import (
@@ -295,6 +300,10 @@ from winipedia_utils.git.gitignore.gitignore import (
     walk_os_skipping_gitignore_patterns,
     add_patterns_to_gitignore
 )
+from winipedia_utils.git.workflows.publish import (
+    load_publish_workflow,
+    dump_publish_workflow
+)
 
 # Check if path is ignored
 if path_is_in_gitignore("dist/"):
@@ -306,12 +315,18 @@ for root, dirs, files in walk_os_skipping_gitignore_patterns("."):
 
 # Add patterns to gitignore
 add_patterns_to_gitignore(["*.log", "temp/"])
+
+# Load and modify publish workflow
+workflow = load_publish_workflow()
+print(f"Workflow name: {workflow.get('name')}")
 ```
 
 **Key Functions:**
 - `path_is_in_gitignore()` - Check if path matches gitignore patterns
 - `walk_os_skipping_gitignore_patterns()` - Directory traversal respecting gitignore
 - `add_patterns_to_gitignore()` - Add patterns to .gitignore file
+- `load_publish_workflow()` - Load GitHub Actions publish workflow
+- `dump_publish_workflow()` - Save GitHub Actions publish workflow
 - Pre-commit configuration management
 
 ---

{winipedia_utils-0.2.17.dist-info → winipedia_utils-0.2.22.dist-info}/RECORD

@@ -16,6 +16,8 @@ winipedia_utils/git/pre_commit/__init__.py,sha256=gFLVGQRmS6abgy5MfPQy_GZiF1_hGx
 winipedia_utils/git/pre_commit/config.py,sha256=HNThJhfA15erOLWNIaOMJN7z6uSGbpNbpFewSvK4qKQ,2262
 winipedia_utils/git/pre_commit/hooks.py,sha256=qBGZa4Gdp6E9Yqhd0boo2SZjDAK2Gzs0QZb7MTc76mg,3657
 winipedia_utils/git/pre_commit/run_hooks.py,sha256=HFsomU-KV89gVLAzmHtLnwekldO8vpTX3Nmmp-aJc0g,1523
+winipedia_utils/git/workflows/__init__.py,sha256=BPdntTwFEyBMJ6MyT7gddPHswvRdH9tsRtfK72VSV7Y,57
+winipedia_utils/git/workflows/publish.py,sha256=OwdnS7fYoVsFz6OedBCF3ae3xCP5RakWuw0FXBpURPw,2468
 winipedia_utils/iterating/__init__.py,sha256=rlF9hzxbowq5yOfcXvOKOQdB-EQmfrislQpf659Zeu4,53
 winipedia_utils/iterating/iterate.py,sha256=fP0cgEOmmwqt5wg6v61Kw3Jx9TtE8bC_a2jVd270NCM,944
 winipedia_utils/logging/__init__.py,sha256=AMt1LwA_E7hexYjMpGzUempoyDdAF-dowWvq59wC5aM,51
@@ -53,7 +55,7 @@ winipedia_utils/resources/svgs/svg.py,sha256=uzlp4Rhnenvkq_YI409ZvR7JMTZmB5JpKsD
 winipedia_utils/security/__init__.py,sha256=HmGXOCROqIGHlBs2bEWRMkEX3rlXNsnA9Tef58AlCo4,52
 winipedia_utils/security/cryptography.py,sha256=5LMat3-9nDW2cQBr_dU7MFRdgbiK53zQqHyacs-Jq-s,793
 winipedia_utils/security/keyring.py,sha256=6kKgSTz1G80F6XeZ3Lskxdl2N6JgUH8gJdFYcGJuysU,2273
-winipedia_utils/setup.py,sha256=GIniddS2gqSV5wYZUkuI2hC7esEChnWA3SyMFYB48Ms,1603
+winipedia_utils/setup.py,sha256=KW9XhQm-NGf9WBe4Jrt3-t2s_pJlBWJ0xUUKwzgMamc,1716
 winipedia_utils/testing/__init__.py,sha256=kXhB5xw02ec5xpcW_KV--9CBKdyCjnuR-NZzAJ5tq0g,51
 winipedia_utils/testing/assertions.py,sha256=WUJwIkPyRduiouqWQwk5-D_mF9ZU1Ffw0q4790lbKnI,828
 winipedia_utils/testing/convention.py,sha256=7vurpqS--awhN_FLSOviSKENGuFyY9Ejr1NKRm0MPsg,4833
@@ -68,13 +70,13 @@ winipedia_utils/testing/tests/base/fixtures/scopes/class_.py,sha256=zesyJxerjI3q
 winipedia_utils/testing/tests/base/fixtures/scopes/function.py,sha256=l1zCCiTkXUSZp0n9QOyejhfszFJiMH88bhGMwNY5r8A,302
 winipedia_utils/testing/tests/base/fixtures/scopes/module.py,sha256=jzr4D6x82xvbCt8x7Han6pDOg27kEiPZf-oPfx2jHN0,1195
 winipedia_utils/testing/tests/base/fixtures/scopes/package.py,sha256=pR3so6QPymIRM4PJTODrlBKI-yQnZ2P78BsiyTPaF8o,302
-winipedia_utils/testing/tests/base/fixtures/scopes/session.py,sha256=uLvqjIWRXCnqD4L4cgzqLJI9hZEETKlE1YW7cJRpH5g,9805
+winipedia_utils/testing/tests/base/fixtures/scopes/session.py,sha256=uJ-xQ7F3SjjtsLlBLCQg2JIGB6YE-Bjg5gTiuj48QfU,10419
 winipedia_utils/testing/tests/base/utils/__init__.py,sha256=mC-8dCkp8xarqkQu2QQLrPjHi6Ww9hcixWdHeQHWeRs,68
 winipedia_utils/testing/tests/base/utils/utils.py,sha256=3c_SNbzjkQypzsc-BONo5C1-Vb7pgbRl6uR6DmTGJRg,3456
 winipedia_utils/testing/tests/conftest.py,sha256=BLgUJtLecOwuEsIyJ__0buqovd5AhiGvbMNk8CHgSQs,888
 winipedia_utils/text/__init__.py,sha256=j2bwtK6kyeHI6SnoBjpRju0C1W2n2paXBDlNjNtaUxA,48
 winipedia_utils/text/string.py,sha256=yXmwOab5hXyVQG1NwlWDpy2prj0U7Vb2F5HKLT2Y77Q,3382
-winipedia_utils-0.2.17.dist-info/METADATA,sha256=oWT6WLbVHY6zcui7EGYGg3Pc5Y3bB68ye7qfhOkbIWg,19905
-winipedia_utils-0.2.17.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-winipedia_utils-0.2.17.dist-info/licenses/LICENSE,sha256=o316mE2gGzd__JT69p7S_zlOmKiHh8YjpImCCcWyTvM,1066
-winipedia_utils-0.2.17.dist-info/RECORD,,
+winipedia_utils-0.2.22.dist-info/METADATA,sha256=IKqMPkc2a9jYTKw3Z_yD3QIjF-Dp4U30nmd_3QRHWVY,20547
+winipedia_utils-0.2.22.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+winipedia_utils-0.2.22.dist-info/licenses/LICENSE,sha256=o316mE2gGzd__JT69p7S_zlOmKiHh8YjpImCCcWyTvM,1066
+winipedia_utils-0.2.22.dist-info/RECORD,,