punit 1.1.9__tar.gz → 1.2.0__tar.gz

{punit-1.1.9/punit.egg-info → punit-1.2.0}/PKG-INFO

@@ -1,21 +1,47 @@
 Metadata-Version: 2.4
-Name: punit
-Version: 1.1.9
+Name: pUnit
+Version: 1.2.0
 Summary: A modernized unit-test framework for Python.
 Author-email: Shaun Wilson <mrshaunwilson@msn.com>
+License: MIT License
+        
+        Copyright (c) Shaun Wilson
+        
+        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.
+        
 Project-URL: Documentation, https://punit.readthedocs.io/
 Project-URL: Homepage, https://github.com/wilson0x4d/punit
 Project-URL: Repository, https://github.com/wilson0x4d/punit.git
-Keywords: test,unittest,unit-test
-Classifier: License :: OSI Approved :: MIT License
+Keywords: test,unittest,unit-test,xUnit,nUnit,pytest
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Intended Audience :: Developers
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
+Requires-Dist: twine; extra == "dev"
 Dynamic: license-file
 
 `pUnit` is a modernized unit-testing framework for Python, inspired by xUnit.
@@ -120,7 +146,7 @@ You can write tests as functions, class methods, instance methods, or static met
 
 ```python
 
-from punit import *
+from punit import fact, theory, inlinedata
 
 @fact
 async def MyLibrary_WhenInitialized_TouchMustReturnTrue:

{punit-1.1.9 → punit-1.2.0}/README.md

@@ -100,7 +100,7 @@ You can write tests as functions, class methods, instance methods, or static met
 
 ```python
 
-from punit import *
+from punit import fact, theory, inlinedata
 
 @fact
 async def MyLibrary_WhenInitialized_TouchMustReturnTrue:

{punit-1.1.9 → punit-1.2.0}/pyproject.toml

@@ -1,21 +1,31 @@
 [project]
-name = "punit"
-version = "1.1.9"
+name = "pUnit"
+version = "1.2.0"
 description = "A modernized unit-test framework for Python."
-keywords = ["test", "unittest", "unit-test"]
+keywords = ["test", "unittest", "unit-test", "xUnit", "nUnit", "pytest"]
 authors = [
     { name="Shaun Wilson", email="mrshaunwilson@msn.com" }
 ]
 readme = "README.md"
+license = {file = "LICENSE"}
 requires-python = ">=3.12"
 classifiers = [
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Intended Audience :: Developers"
 ]
+dependencies = [
+]
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "setuptools",
+    "twine"
+]
 
 [project.urls]
 Documentation = "https://punit.readthedocs.io/"
@@ -27,6 +37,7 @@ requires = ["setuptools"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools.packages.find]
+where = ["src"]
 exclude = [
     "docs",
     "tests",

{punit-1.1.9 → punit-1.2.0/src/pUnit.egg-info}/PKG-INFO

@@ -1,21 +1,47 @@
 Metadata-Version: 2.4
-Name: punit
-Version: 1.1.9
+Name: pUnit
+Version: 1.2.0
 Summary: A modernized unit-test framework for Python.
 Author-email: Shaun Wilson <mrshaunwilson@msn.com>
+License: MIT License
+        
+        Copyright (c) Shaun Wilson
+        
+        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.
+        
 Project-URL: Documentation, https://punit.readthedocs.io/
 Project-URL: Homepage, https://github.com/wilson0x4d/punit
 Project-URL: Repository, https://github.com/wilson0x4d/punit.git
-Keywords: test,unittest,unit-test
-Classifier: License :: OSI Approved :: MIT License
+Keywords: test,unittest,unit-test,xUnit,nUnit,pytest
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Intended Audience :: Developers
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: setuptools; extra == "dev"
+Requires-Dist: twine; extra == "dev"
 Dynamic: license-file
 
 `pUnit` is a modernized unit-testing framework for Python, inspired by xUnit.
@@ -120,7 +146,7 @@ You can write tests as functions, class methods, instance methods, or static met
 
 ```python
 
-from punit import *
+from punit import fact, theory, inlinedata
 
 @fact
 async def MyLibrary_WhenInitialized_TouchMustReturnTrue:

punit-1.2.0/src/pUnit.egg-info/SOURCES.txt

@@ -0,0 +1,31 @@
+LICENSE
+README.md
+pyproject.toml
+.scripts/punit
+src/pUnit.egg-info/PKG-INFO
+src/pUnit.egg-info/SOURCES.txt
+src/pUnit.egg-info/dependency_links.txt
+src/pUnit.egg-info/requires.txt
+src/pUnit.egg-info/top_level.txt
+src/punit/TestResult.py
+src/punit/__init__.py
+src/punit/__main__.py
+src/punit/cli.py
+src/punit/runner.py
+src/punit/assertions/__init__.py
+src/punit/assertions/collections.py
+src/punit/assertions/exceptions.py
+src/punit/assertions/strings.py
+src/punit/discovery/TestModuleDiscovery.py
+src/punit/discovery/__init__.py
+src/punit/facts/Fact.py
+src/punit/facts/FactManager.py
+src/punit/facts/__init__.py
+src/punit/reports/HtmlReportGenerator.py
+src/punit/reports/JUnitReportGenerator.py
+src/punit/reports/__init__.py
+src/punit/theories/Theory.py
+src/punit/theories/TheoryManager.py
+src/punit/theories/__init__.py
+src/punit/traits/Trait.py
+src/punit/traits/__init__.py

punit-1.2.0/src/pUnit.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[dev]
+build
+setuptools
+twine

punit-1.2.0/src/pUnit.egg-info/top_level.txt

@@ -0,0 +1 @@
+punit

{punit-1.1.9 → punit-1.2.0/src}/punit/TestResult.py

@@ -2,12 +2,13 @@
 # SPDX-License-Identifier: MIT
 
 import sys
-from typing import TextIO
+from typing import Any, TextIO, Optional, cast
+
 
 class TextIOCapture:
 
     __quiet:bool
-    output:str = None
+    output:str|None = None
     target:TextIO
 
     def __init__(self, target:TextIO, quiet:bool = False) -> None:
@@ -23,21 +24,22 @@ class TextIOCapture:
         if not self.__quiet:
             self.target.write(text)
 
+
 class TestResult:
 
-    __className:str
-    __exception:Exception
-    __fileName:str
-    __hostName:str
-    __isSuccess:bool
-    __moduleName:str
-    __packageName:str
-    __properties:dict[str, str]
-    __startTime:float
-    __stderrCapture:TextIOCapture
-    __stdoutCapture:TextIOCapture
-    __stopTime:float
-    __testName:str
+    __className:Optional[str]
+    __exception:Exception|None
+    __fileName:str|None
+    __hostName:str|None
+    __isSuccess:bool|None
+    __moduleName:str|None
+    __packageName:str|None
+    __properties:dict[str, Any]
+    __startTime:float|None
+    __stderrCapture:TextIOCapture|None
+    __stdoutCapture:TextIOCapture|None
+    __stopTime:float|None
+    __testName:str|None
 
     def __init__(self):
         self.__className = None
@@ -47,7 +49,7 @@ class TestResult:
         self.__isSuccess = None
         self.__moduleName = None
         self.__packageName = None
-        self.__properties = {}
+        self.__properties = dict[str,Any]()
         self.__startTime = None
         self.__stderrCapture = None
         self.__stdoutCapture = None
@@ -55,15 +57,15 @@ class TestResult:
         self.__testName = None
 
     @property
-    def className(self) -> str:
+    def className(self) -> Optional[str]:
         return self.__className
     
     @className.setter
-    def className(self, value:str) -> None:
+    def className(self, value:Optional[str]) -> None:
         self.__className = value
 
     @property
-    def exception(self) -> Exception:
+    def exception(self) -> Exception|None:
         return self.__exception
     
     @exception.setter
@@ -71,7 +73,7 @@ class TestResult:
         self.__exception = value
 
     @property
-    def fileName(self) -> str:
+    def fileName(self) -> str|None:
         return self.__fileName
     
     @fileName.setter
@@ -79,7 +81,7 @@ class TestResult:
         self.__fileName = value
 
     @property
-    def hostName(self) -> str:
+    def hostName(self) -> str|None:
         return self.__hostName
     
     @hostName.setter
@@ -88,7 +90,7 @@ class TestResult:
 
     @property
     def isSuccess(self) -> bool:
-        return self.__isSuccess
+        return False if self.__isSuccess is None else self.__isSuccess
     
     @isSuccess.setter
     def isSuccess(self, value:bool) -> None:
@@ -96,14 +98,14 @@ class TestResult:
 
     @property
     def moduleName(self) -> str:
-        return self.__moduleName
+        return cast(str,self.__moduleName)
     
     @moduleName.setter
     def moduleName(self, value:str) -> None:
         self.__moduleName = value
 
     @property
-    def packageName(self) -> str:
+    def packageName(self) -> str|None:
         return self.__packageName
     
     @packageName.setter
@@ -111,7 +113,7 @@ class TestResult:
         self.__packageName = value
 
     @property
-    def properties(self) -> dict[str, str]:
+    def properties(self) -> dict[str, Any]:
         return self.__properties
     
     @properties.setter
@@ -119,7 +121,7 @@ class TestResult:
         self.__properties = value
 
     @property
-    def startTime(self) -> float:
+    def startTime(self) -> float|None:
         return self.__startTime
     
     @startTime.setter
@@ -127,15 +129,15 @@ class TestResult:
         self.__startTime = value
 
     @property
-    def stderr(self) -> str:
+    def stderr(self) -> str|None:
         return None if self.__stderrCapture is None else self.__stderrCapture.output
 
     @property
-    def stdout(self) -> str:
+    def stdout(self) -> str|None:
         return None if self.__stdoutCapture is None else self.__stdoutCapture.output
 
     @property
-    def stopTime(self) -> float:
+    def stopTime(self) -> float|None:
         return self.__stopTime
     
     @stopTime.setter
@@ -143,7 +145,7 @@ class TestResult:
         self.__stopTime = value
 
     @property
-    def testName(self) -> str:
+    def testName(self) -> str|None:
         return self.__testName
     
     @testName.setter
@@ -151,13 +153,15 @@ class TestResult:
         self.__testName = value
 
     @property
-    def took(self) -> float:
-        return self.__stopTime - self.__startTime
+    def took(self) -> float|None:
+        return None if self.__stopTime is None or self.__startTime is None else self.__stopTime - self.__startTime
 
     @property
     def tookPretty(self) -> str:
         took = self.took
-        if took >= 1:
+        if took is None:
+            return 'N/A'
+        elif took >= 1:
             return f'{took:.1f}'.rstrip('0').rstrip('.') + 's'
         elif took >= 0.001:
             return f'{(took*1000):.0f}ms'
@@ -169,12 +173,14 @@ class TestResult:
             return f'{(took*1000):.3f}'.rstrip('0').rstrip('.') + 'ms'
 
 
-    def captureOutput(self, quiet:bool = False) -> tuple[TextIO, TextIO]:
+    def captureOutput(self, quiet:bool = False) -> None:
         self.__stdoutCapture = TextIOCapture(sys.stdout, quiet)
         self.__stderrCapture = TextIOCapture(sys.stderr, quiet)
         sys.stdout = self.__stdoutCapture
         sys.stderr = self.__stderrCapture
 
     def releaseOutput(self) -> None:
-        sys.stdout = self.__stdoutCapture.target
-        sys.stderr = self.__stderrCapture.target
+        if self.__stdoutCapture is not None and self.__stdoutCapture.target is not None:
+            sys.stdout = self.__stdoutCapture.target
+        if self.__stderrCapture is not None and self.__stderrCapture.target is not None:
+            sys.stderr = self.__stderrCapture.target

punit-1.2.0/src/punit/__init__.py

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: © Shaun Wilson
+# SPDX-License-Identifier: MIT
+
+__version__ = '1.2.0'
+
+from .assertions import *
+from .facts import *
+from .theories import *
+from .traits import *
+
+
+__all__ = [
+    'assertions',
+    'collections', 'exceptions', 'strings',
+    'facts',
+    'fact',
+    'theories',
+    'theory', 'inlinedata',
+    'traits',
+    'trait'
+]

{punit-1.1.9 → punit-1.2.0/src}/punit/__main__.py

@@ -2,10 +2,13 @@
 # SPDX-License-Identifier: MIT
 
 import asyncio
-from .cli import *
-from .discovery import *
+import os
+import time
+from .cli import CommandLineInterface
+from .discovery import TestModuleDiscovery
 from .reports import HtmlReportGenerator, JUnitReportGenerator
-from .runner import *
+from .runner import TestRunner
+
 
 async def async_main():
     ts = time.time()
@@ -33,18 +36,19 @@ async def async_main():
     if not cli.quiet:
         print(f'Total: {len(results)}, Failures: {failureCount}, Took: {totalTime:.3f}s')
     if cli.reportFormat is not None:
-        report:str = None
+        report:str|None = None
         match cli.reportFormat:
             case 'html':
                 report = HtmlReportGenerator().generate(results)
             case 'junit':
                 report = JUnitReportGenerator().generate(results)
-        if cli.outputFilename is None:
-            print(report)
-        else:
-            with open(cli.outputFilename, 'wb') as file:
-                file.write(report.encode())
-            print(f'\n("{cli.reportFormat}" report written to: {cli.outputFilename})')
+        if report is not None:
+            if cli.outputFilename is None:
+                print(report)
+            else:
+                with open(cli.outputFilename, 'wb') as file:
+                    file.write(report.encode())
+                print(f'\n("{cli.reportFormat}" report written to: {cli.outputFilename})')
     if failureCount > 0:
         exit(119)
 

{punit-1.1.9 → punit-1.2.0/src}/punit/assertions/__init__.py

@@ -1,6 +1,9 @@
 # SPDX-FileCopyrightText: © Shaun Wilson
 # SPDX-License-Identifier: MIT
 
+from . import collections, exceptions, strings
+
+
 __all__ = [
     'collections',
     'exceptions',

{punit-1.1.9 → punit-1.2.0/src}/punit/assertions/collections.py

@@ -1,10 +1,10 @@
 # SPDX-FileCopyrightText: © Shaun Wilson
 # SPDX-License-Identifier: MIT
 
-from typing import Any, Callable, Sequence
+from typing import Any, Callable, Sequence, Optional, cast
 
 
-def areSame(a:Sequence[Any]|None, b:Sequence[Any]|None, sort:bool=False, sortFunction:Callable[[Any], Any]=None) -> bool:
+def areSame(a:Sequence[Any]|None, b:Sequence[Any]|None, sort:bool=False, sortFunction:Optional[Callable[[Any], Any]]=None) -> bool:
     """
     Check if two sequences contain the same elements in the same order.
     
@@ -20,30 +20,31 @@ def areSame(a:Sequence[Any]|None, b:Sequence[Any]|None, sort:bool=False, sortFun
         return False
     elif a is not None and b is None:
         return False
-    elif len(a) != len(b):
-        return False
+    elif a is not None and b is not None:
+        if len(a) != len(b):
+            return False
 
-    if sort:
-        if isinstance(a, dict) or isinstance(b, dict):
-            sortFunction = sortFunction if sortFunction is not None else lambda e: e[0]
-            a = sorted(a.items(), key=sortFunction)
-            b = sorted(b.items(), key=sortFunction)
-        else:
-            sortFunction = sortFunction if sortFunction is not None else lambda e: e
-            a = sorted(a, key=sortFunction)
-            b = sorted(b, key=sortFunction)
+        if sort:
+            if isinstance(a, dict) or isinstance(b, dict):
+                sortFunction = sortFunction if sortFunction is not None else lambda e: e[0]
+                a = sorted(cast(dict,a).items(), key=sortFunction)
+                b = sorted(cast(dict,b).items(), key=sortFunction)
+            else:
+                sortFunction = sortFunction if sortFunction is not None else lambda e: e
+                a = sorted(a, key=sortFunction)
+                b = sorted(b, key=sortFunction)
 
-    if isinstance(a, dict) or isinstance(b, dict):
-        for pairs in zip(a.items(), b.items()):
-            if not areSame(pairs[0], pairs[1]):
-                return False            
-    else:
-        for pairs in zip(a, b):
-            if isinstance(pairs[0], dict) or isinstance(pairs[1], dict):
+        if isinstance(a, dict) or isinstance(b, dict):
+            for pairs in zip(cast(dict,a).items(), cast(dict,b).items()):
                 if not areSame(pairs[0], pairs[1]):
                     return False            
-            elif pairs[0] != pairs[1]:
-                    return False
+        else:
+            for pairs in zip(a, b):
+                if isinstance(pairs[0], dict) or isinstance(pairs[1], dict):
+                    if not areSame(pairs[0], pairs[1]):
+                        return False            
+                elif pairs[0] != pairs[1]:
+                        return False
     return True
 
 def hasLength(sequence:Sequence[Any]|None, expected:int|None) -> bool:
@@ -61,7 +62,7 @@ def hasLength(sequence:Sequence[Any]|None, expected:int|None) -> bool:
         return False
     elif sequence is not None and expected is None:
         return False
-    return len(sequence) == expected
+    return sequence is not None and len(sequence) == expected
 
 def isNoneOrEmpty(sequence:Sequence[Any]|None) -> bool:
     """

{punit-1.1.9 → punit-1.2.0/src}/punit/assertions/exceptions.py

@@ -1,21 +1,24 @@
 # SPDX-FileCopyrightText: © Shaun Wilson
 # SPDX-License-Identifier: MIT
 
-from typing import Callable, get_args
+from typing import Any, Callable, Optional, cast, get_args
+
 
 def isNoneOrWhiteSpace(input:str):
     return input is None or len(input.lstrip()) == 0
 
+
 def isNoneOrEmpty(input:str):
     return input is None or len(input) == 0
 
+
 class raises[TError:Exception]:
     
     __action:Callable
     __exact:bool
-    __expect:TError
+    __expect:Optional[TError|type]
 
-    def __init__(self, action:Callable, *, exact:bool = False, expect:TError = None) -> None:
+    def __init__(self, action:Callable, *, exact:bool = False, expect:Optional[TError|type] = None) -> None:
         self.__action = action
         self.__exact = exact
         self.__expect = expect
@@ -25,10 +28,10 @@ class raises[TError:Exception]:
             self.__action()
         except BaseException as ex:
             expected = self.__expect
-            if expected is None:
-                expected = get_args(self.__orig_class__)[0]
+            if expected is None and hasattr(self, '__orig_class__') is not None:
+                expected = get_args(getattr(self, '__orig_class__'))[0]
             if self.__exact:
                 return type(ex) is expected
-            else:
-                return issubclass(type(ex), expected)
+            elif expected is not None:
+                return issubclass(type(ex), cast(Any,expected))
         return False

{punit-1.1.9 → punit-1.2.0/src}/punit/assertions/strings.py

@@ -14,17 +14,16 @@ def areSame(a:str|None, b:str|None) -> bool:
     Returns:
         True if the strings contain the same characters in the same order, False otherwise
     """
-    if a is b:
-        return True
-    elif a is None and b is not None:
+    if a is None and b is not None:
         return False
     elif a is not None and b is None:
         return False
-    elif len(a) != len(b):
-        return False
-    for i in range(len(a)):
-        if a[i] != b[i]:
+    elif a is not None and b is not None:
+        if len(a) != len(b):
             return False
+        for i in range(len(a)):
+            if a[i] != b[i]:
+                return False
     return True
 
 def isNoneOrEmpty(string:str|None) -> bool: