winipedia-utils 0.1.2__tar.gz → 0.1.4__tar.gz

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: winipedia-utils
-Version: 0.1.2
+Version: 0.1.4
 Summary: A package with many utility functions
 License: MIT
 Author: Winipedia
@@ -150,11 +150,11 @@ create_tests()
 ### Module Introspection
 
 ```python
-from winipedia_utils.modules.package import get_scr_package, walk_package
+from winipedia_utils.modules.package import get_src_package, walk_package
 from winipedia_utils.modules.function import get_all_functions_from_module
 
 # Discover your main source package
-src_package = get_scr_package()
+src_package = get_src_package()
 
 # Walk through all modules in a package
 for package, modules in walk_package(src_package):

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/README.md

@@ -129,11 +129,11 @@ create_tests()
 ### Module Introspection
 
 ```python
-from winipedia_utils.modules.package import get_scr_package, walk_package
+from winipedia_utils.modules.package import get_src_package, walk_package
 from winipedia_utils.modules.function import get_all_functions_from_module
 
 # Discover your main source package
-src_package = get_scr_package()
+src_package = get_src_package()
 
 # Walk through all modules in a package
 for package, modules in walk_package(src_package):

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/pyproject.toml

@@ -1,7 +1,7 @@
 # Project section
 [project]
 name = "winipedia-utils"
-version = "0.1.2"
+version = "0.1.4"
 description = "A package with many utility functions"
 readme = "README.md"
 requires-python = ">=3.12"

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/winipedia_utils/modules/package.py

@@ -28,7 +28,7 @@ from winipedia_utils.logging.logger import get_logger
 logger = get_logger(__name__)
 
 
-def get_scr_package() -> ModuleType:
+def get_src_package() -> ModuleType:
     """Identify and return the main source package of the project.
 
     Discovers the main source package by finding all top-level packages

winipedia_utils-0.1.4/winipedia_utils/projects/project.py

@@ -0,0 +1,19 @@
+"""Utilities for working with Python projects."""
+
+from winipedia_utils.modules.module import create_module, to_path
+from winipedia_utils.modules.package import get_src_package
+from winipedia_utils.projects.poetry.config import get_poetry_package_name
+
+
+def _create_project_root() -> None:
+    """Create the project root."""
+    src_package_name = get_poetry_package_name()
+    create_module(src_package_name, is_package=True)
+    _create_py_typed()
+
+
+def _create_py_typed() -> None:
+    """Create the py.typed file."""
+    src_package_name = get_src_package().__name__
+    py_typed_path = to_path(src_package_name, is_package=True) / "py.typed"
+    py_typed_path.touch()

winipedia_utils-0.1.4/winipedia_utils/py.typed

@@ -0,0 +1 @@
+

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/winipedia_utils/setup.py

@@ -16,6 +16,7 @@ from winipedia_utils.projects.poetry.config import (
 from winipedia_utils.projects.poetry.poetry import (
     _install_dev_dependencies,
 )
+from winipedia_utils.projects.project import _create_project_root
 
 logger = get_logger(__name__)
 
@@ -30,6 +31,8 @@ def _setup() -> None:
     _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()
     logger.info("Setup complete!")

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/winipedia_utils/testing/create_tests.py

@@ -24,7 +24,7 @@ from winipedia_utils.modules.module import (
 )
 from winipedia_utils.modules.package import (
     copy_package,
-    get_scr_package,
+    get_src_package,
     walk_package,
 )
 from winipedia_utils.testing import tests
@@ -80,7 +80,7 @@ def create_tests_for_src_package() -> None:
     This function walks through the source package hierarchy and creates corresponding
     test packages and modules for each package and module found in the source.
     """
-    src_package = get_scr_package()
+    src_package = get_src_package()
     for package, modules in walk_package(src_package):
         create_test_package(package)
         for module in modules:

{winipedia_utils-0.1.2 → winipedia_utils-0.1.4}/winipedia_utils/testing/tests/base/fixtures/scopes/session.py

@@ -17,7 +17,7 @@ from winipedia_utils.git.pre_commit.config import (
 from winipedia_utils.modules.module import to_path
 from winipedia_utils.modules.package import (
     find_packages,
-    get_scr_package,
+    get_src_package,
     walk_package,
 )
 from winipedia_utils.projects.poetry.config import (
@@ -188,7 +188,7 @@ def _test_all_src_code_in_one_package() -> None:
 
     """
     packages = find_packages(depth=0)
-    src_package = get_scr_package().__name__
+    src_package = get_src_package().__name__
     expected_packages = {TESTS_PACKAGE_NAME, src_package}
     assert_with_msg(
         set(packages) == expected_packages,
@@ -196,6 +196,44 @@ def _test_all_src_code_in_one_package() -> None:
     )
 
 
+@autouse_session_fixture
+def _test_src_package_correctly_named() -> None:
+    """Verify that the source package is correctly named.
+
+    This fixture runs once per test session and checks that the source package
+    is correctly named after the project.
+
+    Raises:
+        AssertionError: If the source package is not correctly named
+
+    """
+    src_package = get_src_package().__name__
+    assert_with_msg(
+        src_package == get_poetry_package_name(),
+        f"Expected source package to be named {get_poetry_package_name()}, "
+        f"but it is named {src_package}",
+    )
+
+
+@autouse_session_fixture
+def _test_py_typed_exists() -> None:
+    """Verify that the py.typed file exists in the source package.
+
+    This fixture runs once per test session and checks that the py.typed file
+    exists in the source package.
+
+    Raises:
+        AssertionError: If the py.typed file doesn't exist
+
+    """
+    src_package = get_src_package()
+    py_typed_path = to_path(src_package.__name__, is_package=True) / "py.typed"
+    assert_with_msg(
+        py_typed_path.exists(),
+        f"Expected py.typed file to exist at {py_typed_path}",
+    )
+
+
 @autouse_session_fixture
 def _test_project_structure_mirrored() -> None:
     """Verify that the project structure is mirrored in tests.
@@ -207,7 +245,7 @@ def _test_project_structure_mirrored() -> None:
         AssertionError: If any package or module doesn't have a corresponding test
 
     """
-    src_package = get_scr_package()
+    src_package = get_src_package()
 
     # we will now go through all the modules in the src package and check
     # that there is a corresponding test module