emtest 0.0.1__py3-none-any.whl → 0.0.4__py3-none-any.whl

_auto_run_with_pytest/__init__.py

@@ -0,0 +1,32 @@
+"""Rerun the orignially executed python script in pytest instead of python."""
+
+import os
+import sys
+
+from emtest import run_pytest
+
+# Configuration for standalone execution
+
+path_parts = sys.argv[0].split(os.sep)
+if not (
+    path_parts[-1] == "pytest"
+    or (
+        len(path_parts) > 1
+        and path_parts[-2] == "pytest"
+        and path_parts[-1] == "__main__.py"
+    )
+):
+    test_file = os.path.abspath(sys.argv[0])
+    pytest_args = sys.argv[1:]
+    # print("RERUNNING IN PYTEST:", test_file)
+
+    # Use emtest's custom test runner with specific settings:
+    run_pytest(
+        test_path=test_file,  # Run tests in this file
+        pytest_args=pytest_args,
+    )
+
+    sys.exit(-1)
+else:
+    # print("ALREADY RUNNING IN PYTEST")
+    pass

emtest/__init__.py

@@ -1,7 +1,14 @@
-from .pytest_utils import run_pytest, configure_pytest_reporter
+from .pytest_utils import run_pytest, configure_pytest_reporter, env_vars
 from .testing_utils import (
     add_path_to_python,
     assert_is_loaded_from_source,
     polite_wait,
     await_thread_cleanup,
-)
+    get_thread_names,
+    set_env_var,
+    are_we_in_docker,
+    make_dir,
+    delete_path,
+    ensure_dirs_exist,
+    ensure_dir_exists,
+)

emtest/pytest_utils.py

@@ -1,6 +1,6 @@
 
 
-
+from .testing_utils import set_env_var
 import os
 import sys
 from typing import Any, Optional
@@ -9,24 +9,29 @@ from _pytest.config import Config
 from _pytest.reports import TestReport
 from termcolor import colored
 
+from environs import Env
+env_vars = Env()
+
+
 class MinimalReporter(TerminalReporter):
     """Custom pytest reporter that provides clean, minimal output with colored symbols.
-    
+
     This reporter suppresses most default pytest output and displays only:
     - ✓ for passed tests (green)
     - ✗ for failed tests (red) 
     - - for skipped tests (yellow)
     """
-    def __init__(self, config: Config) -> None:
+
+    def __init__(self, config: Config, print_errors: bool = True) -> None:
         super().__init__(config)
         self._tw.hasmarkup = True  # enables colored output safely
+        self.print_errors = print_errors
+        self.current_test_file = ""
 
-    def _write_output(self, *args: Any, **kwargs: Any) -> None:
-        """Override default output methods to suppress them."""
-        pass  # override all default output methods
+    def report_collect(self, final: bool = False) -> None:
+        pass
 
-    def _write_summary(self) -> None:
-        """Override summary writing to suppress it."""
+    def pytest_collection(self) -> None:
         pass
 
     def pytest_sessionstart(self, session: Any) -> None:
@@ -37,6 +42,10 @@ class MinimalReporter(TerminalReporter):
     def pytest_runtest_logstart(self, nodeid: str, location: Any) -> None:
         """Override test start logging to suppress it."""
         # print("pytest_runtest_logstart")
+        current_test_file = os.path.basename(location[0]).strip(".py")
+        if current_test_file != self.current_test_file:
+            self.current_test_file = current_test_file
+            print(f"\n{self.current_test_file}")
         pass  # suppress test start lines
 
     def pytest_runtest_logreport(self, report: TestReport) -> None:
@@ -46,12 +55,20 @@ class MinimalReporter(TerminalReporter):
 
         test_name = report.nodeid.split("::")[-1]
         if report.passed:
-            symbol = colored("✓", "green")
+            self.write("✓", green=True)
+            # symbol = colored("✓", "green")
         elif report.failed:
-            symbol = colored("✗", "red")
+            self.write("✗", red=True)
+            # symbol = colored("✗", "red")
         elif report.skipped:
-            symbol = colored("-", "yellow")
-        print(f"{symbol} {test_name}")
+            self.write("-", yellow=True)
+            # symbol = colored("-", "yellow")
+        # self.write(f"{symbol} {test_name}")
+
+        self.write(f" {test_name}\n")
+
+        if self.print_errors and report.failed:
+            print(colored(report.longreprtext, "red"))
 
     def summary_stats(self) -> None:
         """Override result counts to suppress them."""
@@ -62,30 +79,53 @@ class MinimalReporter(TerminalReporter):
         pass  # suppress final summary output
 
 
-def configure_pytest_reporter(config: Config) -> None:
+# Environment Variable and CLI option to deactivate MinimalReporter
+PYTEST_STANDARD_OUTPUT_ENV = "DEFAULT_TERMINAL_REPORTER"
+PYTEST_STANDARD_OUTPUT_OPT = "--default-terminal-reporter"
+if PYTEST_STANDARD_OUTPUT_OPT in sys.argv:
+    set_env_var(PYTEST_STANDARD_OUTPUT_ENV, "1", True)
+
+
+def configure_pytest_reporter(config: Config, print_errors=True) -> None:
     """Configure the minimal reporter if terminalreporter plugin is disabled.
-    
+
     Args:
         config: Pytest configuration object
     """
+    if env_vars.bool(PYTEST_STANDARD_OUTPUT_ENV, default=False):
+        return
+    minimal_reporter = MinimalReporter(config, print_errors=print_errors)
     # if terminalreporter plugin is disabled
     if "no:terminalreporter" in config.option.plugins:
         pluginmanager = config.pluginmanager
-        pluginmanager.register(MinimalReporter(config), "minimal-reporter")
+        pluginmanager.register(minimal_reporter, "minimal-reporter")
+
+    if config.pluginmanager.has_plugin("terminalreporter"):
+        reporter = config.pluginmanager.get_plugin("terminalreporter")
+        config.pluginmanager.unregister(reporter, "terminalreporter")
+        config.pluginmanager.register(minimal_reporter, "terminalreporter")
 
 
-def run_pytest(test_path: str, breakpoints: bool, deactivate_pytest_output: bool = False, enable_print: bool = False) -> None:
+def run_pytest(
+    test_path: str,
+    breakpoints: bool = False,
+    enable_print: bool = False,
+    pytest_args: list[str] | None = None
+) -> None:
     """Run pytest with customizable options for output control and debugging.
-    
+
     Args:
         test_path: Path to the test file or directory to run
         breakpoints: If True, enables pytest debugger (--pdb) on failures
         deactivate_pytest_output: If True, uses minimal reporter instead of default output
         enable_print: If True, enables print statements in tests (-s flag)
     """
-    args = []
-    if deactivate_pytest_output:
-        args += ["-p", "no:terminalreporter"]
+    if pytest_args:
+        args = pytest_args
+        if PYTEST_STANDARD_OUTPUT_OPT in args:
+            args.remove(PYTEST_STANDARD_OUTPUT_OPT)
+    else:
+        args = []
     if enable_print:
         args.append("-s")  # -s disables output capturing
     if breakpoints:

emtest/testing_utils.py

@@ -2,6 +2,7 @@
 
 import os
 import sys
+import shutil
 import threading
 import time
 from time import sleep
@@ -11,15 +12,20 @@ from tqdm import TMonitor, tqdm
 from types import ModuleType
 
 
+def are_we_in_docker() -> bool:
+    """Check if this code is running in a docker container."""
+    return os.path.exists('/.dockerenv')
+
+
 def add_path_to_python(src_path: str) -> None:
     """Add a directory to the Python path for importing modules.
-    
+
     Removes the path if it already exists, then inserts it at the beginning
     of sys.path to ensure it takes priority over installed packages.
-    
+
     Args:
         src_path: Directory path to add to Python path
-        
+
     Raises:
         FileNotFoundError: If the path doesn't exist
         NotADirectoryError: If the path is not a directory
@@ -64,7 +70,7 @@ def assert_is_loaded_from_source(
 
 def polite_wait(n_sec: int) -> None:
     """Wait for the given duration, displaying a progress bar.
-    
+
     Args:
         n_sec: Number of seconds to wait
     """
@@ -75,10 +81,10 @@ def polite_wait(n_sec: int) -> None:
 
 def await_thread_cleanup(timeout: int = 5) -> bool:
     """Wait for all threads to exit, with a timeout and progress bar.
-    
+
     Args:
         timeout: Maximum seconds to wait for thread cleanup
-        
+
     Returns:
         True if only the main thread remains, False if other threads persist
     """
@@ -95,4 +101,54 @@ def await_thread_cleanup(timeout: int = 5) -> bool:
 
     return len(get_threads()) == 1
 
+def get_thread_names():
+    """Get a list of the names of all active threads."""
+    return [thread.name for thread in threading.enumerate()]
+
+def set_env_var(name: str, value: str | bool | int, override: bool = True):
+    """
+    Set an environment variable with optional overriding behavior.
 
+    Args:
+        name (str): The name of the environment variable to set.
+        value (str): The value to assign to the environment variable.
+        override (bool, optional): Whether to overwrite the variable if it is already set.
+                                   Defaults to False.
+
+    Behavior:
+        - If 'override' is True, the environment variable will always be set to 'value'.
+        - If 'override' is False, the variable will only be set if it is not already defined.
+    """
+    if isinstance(value, bool):
+        value = int(value)
+    if isinstance(value, int):
+        value = str(value)
+    if override or name not in os.environ:
+        os.environ[name] = value
+
+def make_dir(dir_path: str, clear_existing: bool = False) -> str:
+    """Create a directory, handling the case where it already exists."""
+    if clear_existing and os.path.exists(dir_path):
+        shutil.rmtree(dir_path)
+    if not os.path.isdir(dir_path):
+        os.makedirs(dir_path)
+    return dir_path
+
+
+def delete_path(path: bool) -> bool:
+    """Delete the specified file or folder."""
+    if os.path.isdir(path):
+        shutil.rmtree(path)
+    elif os.path.exists(path):
+        os.remove(path)
+
+def ensure_dirs_exist(*dirs):
+    """Ensure that all directories in the list exist."""
+    for dir in dirs:
+        os.makedirs(dir, exist_ok=True)
+
+
+def ensure_dir_exists(dir_path):
+    if not os.path.exists(dir_path):
+        os.makedirs(dir_path)
+    return dir_path

emtest-0.0.4.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: emtest
+Version: 0.0.4
+Summary: Testing utilities which I find useful.
+Author-email: Emendir <dev@emendir.tech>
+License-Expression: MIT-0 OR CC0-1.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE-CC0
+Requires-Dist: tqdm
+Dynamic: license-file
+
+# emtest - Python Testing Utilities
+
+A Python package providing testing utilities.
+
+## Features
+
+### 🎨 Clean Test Output for Pytest
+- **MinimalReporter**: Custom pytest reporter with clean, colored output using simple symbols (✓/✗/-)
+- **Configurable Output**: Toggle between minimal and standard pytest output modes
+
+### 🔧 Development Utilities  
+- **Source Path Management**: Dynamically add directories to Python path for testing source code
+- **Module Source Validation**: Ensure modules are loaded from source directories (not installed packages)
+- **Thread Cleanup Monitoring**: Wait for and verify proper thread cleanup in tests
+
+### ⚡ Enhanced Test Execution
+- **Dual Execution Pattern**: Run tests both as pytest tests and standalone Python scripts
+- **Breakpoint Integration**: Easy debugging with pytest's `--pdb` integration
+- **Progress Indicators**: Visual progress bars for waiting operations
+
+## Installation
+
+```sh
+pip install emtest
+```
+
+## Usage
+
+See the `examples/` directory for complete working examples showing:
+- Basic test setup with `conftest.py`
+- Dual execution pattern implementation
+- Source loading validation
+- Thread cleanup testing
+
+
+## Documentation
+
+- [Full Documentation](docs/README.md):
+  - [API-Reference](docs/API-Reference/README.html)
+
+## Roadmap
+
+## Contributing
+
+### Get Involved
+
+- GitHub Discussions: if you want to share ideas
+- GitHub Issues: if you find bugs, other issues, or would like to submit feature requests
+- GitHub Merge Requests: if you think you know what you're doing, you're very welcome!
+
+### Donations
+
+To support me in my work on this and other projects, you can make donations with the following currencies:
+
+- **Bitcoin:** `BC1Q45QEE6YTNGRC5TSZ42ZL3MWV8798ZEF70H2DG0`
+- **Ethereum:** `0xA32C3bBC2106C986317f202B3aa8eBc3063323D4`
+- [**Fiat** (via Credit or Debit Card, Apple Pay, Google Pay, Revolut Pay)](https://checkout.revolut.com/pay/4e4d24de-26cf-4e7d-9e84-ede89ec67f32)
+
+Donations help me:
+- dedicate more time to developing and maintaining open-source projects
+- cover costs for IT infrastructure
+- finance projects requiring additional hardware & compute
+
+## About the Developer
+
+This project is developed by a human one-man team, publishing under the name _Emendir_.  
+I build open technologies trying to improve our world;
+learning, working and sharing under the principle:
+
+> _Freely I have received, freely I give._
+
+Feel welcome to join in with code contributions, discussions, ideas and more!
+
+## Open-Source in the Public Domain
+
+I dedicate this project to the public domain.
+It is open source and free to use, share, modify, and build upon without restrictions or conditions.
+
+I make no patent or trademark claims over this project.  
+
+Formally, you may use this project under either the: 
+- [MIT No Attribution (MIT-0)](https://choosealicense.com/licenses/mit-0/) or
+- [Creative Commons Zero (CC0)](https://choosealicense.com/licenses/cc0-1.0/)
+licence at your choice.  
+
+

emtest-0.0.4.dist-info/RECORD

@@ -0,0 +1,10 @@
+_auto_run_with_pytest/__init__.py,sha256=P2Tgn9TbVJvNiyOygCrBso4uAd7Og9suuHmKE0-CEtU,753
+emtest/__init__.py,sha256=G_EnVC57IL_OjVJAjaz75y9owlCcdbvXfvR-ncO1icU,344
+emtest/pytest_utils.py,sha256=qGKGlQTIgKi3BjmUTfcqzPE_0QfWkWfefy8Oitq3sdQ,4844
+emtest/testing_utils.py,sha256=lzXRXwA50YQBHO35Y2s6NcbvgrdTcwGJjJ79CkzJKkk,4780
+emtest-0.0.4.dist-info/licenses/LICENSE,sha256=i720OgyQLs68DSskm7ZLzaGKMnfskBIIHOuPWfwT2q4,907
+emtest-0.0.4.dist-info/licenses/LICENSE-CC0,sha256=kXBMw0w0VVXQAbLjqMKmis4OngrPaK4HY9ScH6MdtxM,7038
+emtest-0.0.4.dist-info/METADATA,sha256=Brr2oyYeArMDrP0K17UTUELzQ-LiUURmAQgDlfXMUXE,3395
+emtest-0.0.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+emtest-0.0.4.dist-info/top_level.txt,sha256=sfToBhqMjk35PDheZ42yiMGYNYatT3V5Mwhb79fp5dE,29
+emtest-0.0.4.dist-info/RECORD,,

emtest-0.0.4.dist-info/licenses/LICENSE

@@ -0,0 +1,18 @@
+MIT No Attribution
+
+Copyright [year] [fullname]
+
+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.
+
+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.

emtest-0.0.1.dist-info/licenses/LICENCE → emtest-0.0.4.dist-info/licenses/LICENSE-CC0

@@ -101,7 +101,7 @@ express Statement of Purpose.
 
 4. Limitations and Disclaimers.
 
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
+ a. No trademark rights held by Affirmer are waived, abandoned,
     surrendered, licensed or otherwise affected by this document.
  b. Affirmer offers the Work as-is and makes no representations or
     warranties of any kind concerning the Work, express, implied,
@@ -118,4 +118,4 @@ express Statement of Purpose.
     Work.
  d. Affirmer understands and acknowledges that Creative Commons is not a
     party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
+    this CC0 or use of the Work.

emtest-0.0.4.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+_auto_run_with_pytest
+emtest

emtest-0.0.1.dist-info/METADATA

@@ -1,49 +0,0 @@
-Metadata-Version: 2.4
-Name: emtest
-Version: 0.0.1
-Summary: Testing utilities which I find useful.
-Author-email: Emendir <dev@emendir.tech>
-License-Expression: CC0-1.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENCE
-Requires-Dist: tqdm
-Dynamic: license-file
-
-# emtest - Python Testing Utilities
-
-A Python package providing testing utilities.
-
-## Features
-
-### 🎨 Clean Test Output for Pytest
-- **MinimalReporter**: Custom pytest reporter with clean, colored output using simple symbols (✓/✗/-)
-- **Configurable Output**: Toggle between minimal and standard pytest output modes
-
-### 🔧 Development Utilities  
-- **Source Path Management**: Dynamically add directories to Python path for testing source code
-- **Module Source Validation**: Ensure modules are loaded from source directories (not installed packages)
-- **Thread Cleanup Monitoring**: Wait for and verify proper thread cleanup in tests
-
-### ⚡ Enhanced Test Execution
-- **Dual Execution Pattern**: Run tests both as pytest tests and standalone Python scripts
-- **Breakpoint Integration**: Easy debugging with pytest's `--pdb` integration
-- **Progress Indicators**: Visual progress bars for waiting operations
-
-## Installation
-
-```sh
-pip install emtest
-```
-
-## Usage
-
-See the `examples/` directory for complete working examples showing:
-- Basic test setup with `conftest.py`
-- Dual execution pattern implementation
-- Source loading validation
-- Thread cleanup testing
-
-

emtest-0.0.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-emtest/__init__.py,sha256=tC-Hx6hKUVswMSIik-RwLF4fO4rDaZXi05DzDkixoCE,195
-emtest/pytest_utils.py,sha256=0vVNw6P4FdS7BsX18GMXK7bne-hfSNWiLtRS0sLiZOA,3486
-emtest/testing_utils.py,sha256=uZeEw4EKhy_2sUIzUPF1kvfVfyis3mF7Q5SSj9uxzCU,2899
-emtest-0.0.1.dist-info/licenses/LICENCE,sha256=bUia9ikmYtnjbTTOSUI3hJhKX25B17WPSbASZN9Z-gM,7047
-emtest-0.0.1.dist-info/METADATA,sha256=UWQ9-OOa4u74B_kwP8BG2-2c77u1Mjod5mXS71TnGOM,1570
-emtest-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-emtest-0.0.1.dist-info/top_level.txt,sha256=8yXylA__VmNeIDW3MBOmSiOpUCZoEprrys-qdB54CLo,7
-emtest-0.0.1.dist-info/RECORD,,

emtest-0.0.1.dist-info/top_level.txt

@@ -1 +0,0 @@
-emtest