specmatic 0.9.0__py3-none-any.whl → 0.9.1__py3-none-any.whl

specmatic/core/specmatic.py

@@ -12,26 +12,31 @@ from specmatic.utils import get_junit_report_file_path
 
 class Specmatic:
     def __init__(self):
-        self.reset_app_config_func = None
-        self.set_app_config_func = None
+        self.app = None
+        self.app_module = ''
         self.app_host = '127.0.0.1'
         self.app_port = 0
-        self.app_module = ''
-        self.app = None
-        self.test_args = None
+        self.reset_app_config_func = None
+        self.set_app_config_func = None
+        self.app_server = None
+
+        self.stub_host = None
+        self.stub_port = None
+        self.expectations = None
         self.stub_args = None
+        self.stub = None
+
         self.test_class = None
-        self.test_port = None
         self.test_host = None
-        self.app_server = None
-        self.expectations = None
-        self.stub_port = None
-        self.stub_host = None
+        self.test_port = None
+        self.test_args = None
+
+        self.project_root = ''
+        self.specmatic_json_file_path = ''
+
         self.run_stub = False
         self.run_app = False
         self.run_tests = False
-        self.project_root = ''
-        self.specmatic_json_file_path = ''
 
     def with_project_root(self, project_root):
         self.project_root = project_root
@@ -54,30 +59,24 @@ class Specmatic:
         self.run_app = True
         return self
 
-    def with_app(self, app):
+    def with_wsgi_app(self, app, host: str = '127.0.0.1', port: int = 0, set_app_config_func=None,
+                      reset_app_config_func=None):
         self.app = app
+        self.app_host = host
+        self.app_port = port
+        self.set_app_config_func = set_app_config_func
+        self.reset_app_config_func = reset_app_config_func
         self.run_app = True
         return self
 
-    def with_app_module(self, app_module: str):
+    def with_asgi_app(self, app_module: str, host: str = '127.0.0.1', port: int = 0, set_app_config_func=None,
+                      reset_app_config_func=None):
         self.app_module = app_module
-        self.run_app = True
-        return self
-
-    def with_app_host(self, host: str):
         self.app_host = host
-        return self
-
-    def with_app_port(self, port: int):
         self.app_port = port
-        return self
-
-    def with_set_app_config_func(self, set_app_config_func):
         self.set_app_config_func = set_app_config_func
-        return self
-
-    def with_reset_app_config_func(self, reset_app_config_func):
         self.reset_app_config_func = reset_app_config_func
+        self.run_app = True
         return self
 
     def test(self, test_class, test_host: str = '127.0.0.1', test_port: int = 0, args=None):
@@ -88,38 +87,46 @@ class Specmatic:
         self.run_tests = True
         return self
 
+    def __init_app_server(self):
+        if self.run_app:
+            if self.app is None and self.app_module == '':
+                raise Exception('Please specify either an app or an app_module.')
+            if self.app is not None and self.app_module != '':
+                raise Exception('Please specify only one of app or app_module, and not both.')
+            if self.app is not None:
+                self.app_server = WSGIAppServer(self.app, self.app_host, self.app_port, self.set_app_config_func,
+                                                self.reset_app_config_func)
+            else:
+                self.app_server = ASGIAppServer(self.app_module, self.app_host, self.app_port, self.set_app_config_func,
+                                                self.reset_app_config_func)
+
+    def __start_stub(self):
+        if self.run_stub:
+            self.stub = SpecmaticStub(self.stub_host, self.stub_port, self.project_root, self.specmatic_json_file_path,
+                                      self.stub_args)
+            self.stub.set_expectations(self.expectations)
+            self.app_server.set_app_config(self.stub.host, self.stub.port)
+
+    def __execute_tests(self):
+        if self.run_tests:
+            if self.app_server is not None:
+                self.app_server.start()
+                self.test_host = self.app_server.host
+                self.test_port = self.app_server.port
+            SpecmaticTest(self.test_host, self.test_port, self.project_root,
+                          self.specmatic_json_file_path, self.test_args).run()
+            if issubclass(self.test_class, unittest.TestCase):
+                print("Injecting unittest methods")
+                UnitTestGenerator(self.test_class, get_junit_report_file_path()).generate()
+            else:
+                print("Injecting pytest methods")
+                PyTestGenerator(self.test_class, get_junit_report_file_path()).generate()
+
     def run(self):
-        stub = None
         try:
-            if self.run_app:
-                if self.app is None and self.app_module == '':
-                    raise Exception('Please specify either app or app_module.')
-                if self.app is not None and self.app_module != '':
-                    raise Exception('Please specify only one of app or app_module, and not both.')
-                if self.app is not None:
-                    self.app_server = WSGIAppServer(self.app, self.app_host, self.app_port, self.set_app_config_func,
-                                                    self.reset_app_config_func)
-                else:
-                    self.app_server = ASGIAppServer(self.app_module, self.app_host, self.app_port, self.set_app_config_func,
-                                                    self.reset_app_config_func)
-            if self.run_stub:
-                stub = SpecmaticStub(self.stub_host, self.stub_port, self.project_root, self.specmatic_json_file_path,
-                                     self.stub_args)
-                stub.set_expectations(self.expectations)
-                self.app_server.set_app_config(stub.host, stub.port)
-            if self.run_tests:
-                if self.app_server is not None:
-                    self.app_server.start()
-                    self.test_host = self.app_server.host
-                    self.test_port = self.app_server.port
-                SpecmaticTest(self.test_host, self.test_port, self.project_root,
-                              self.specmatic_json_file_path, self.test_args).run()
-                if issubclass(self.test_class, unittest.TestCase):
-                    print("Injecting unittest methods")
-                    UnitTestGenerator(self.test_class, get_junit_report_file_path()).generate()
-                else:
-                    print("Injecting pytest methods")
-                    PyTestGenerator(self.test_class, get_junit_report_file_path()).generate()
+            self.__init_app_server()
+            self.__start_stub()
+            self.__execute_tests()
         except Exception as e:
             print(f"Error: {e}")
             raise e
@@ -127,5 +134,5 @@ class Specmatic:
             if self.app_server is not None:
                 self.app_server.stop()
                 self.app_server.reset_app_config()
-            if stub is not None:
-                stub.stop()
+            if self.stub is not None:
+                self.stub.stop()

specmatic/servers/asgi_app_server.py

@@ -43,6 +43,9 @@ class ASGIAppServer(AppServer):
     def __read_process_output(self):
         try:
             for line in iter(self.__process.stdout.readline, ''):
+                if self.__process.poll() is not None:
+                    line = line.decode()
+                    raise Exception('App process terminated due to an error ' + line)
                 if line:
                     line = line.decode().rstrip()
                     print(line)

specmatic/version.py

@@ -1,2 +1,2 @@
-__version__ = '0.9.0'
+__version__ = '0.9.1'
 __specmatic_version__ = '0.68.0'

{specmatic-0.9.0.dist-info → specmatic-0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: specmatic
-Version: 0.9.0
+Version: 0.9.1
 Summary: A Python module for using the Specmatic Library.
 Home-page: https://github.com/znsio/specmatic-python-extensions
 Author: Specmatic Builders
@@ -54,9 +54,7 @@ class TestContract:
 Specmatic() \
     .with_project_root(PROJECT_ROOT) \
     .with_stub(stub_host, stub_port, [expectation_json_file]) \
-    .with_app(app) \
-    .with_app_host(app_host)\
-    .with_app_port(app_port)\
+    .with_wsgi_app(app, app_host, app_port) \
     .test(TestContract) \
     .run()
 `````` 
@@ -83,9 +81,7 @@ class TestContract:
     
 Specmatic() \
     .with_project_root(PROJECT_ROOT) \
-    .with_app(app) \
-    .with_app_host(app_host)\
-    .with_app_port(app_port)\
+    .with_wsgi_app(app, app_host, app_port) \
     .test(TestContract) \
     .run()
 ``````                        
@@ -93,7 +89,7 @@ Specmatic() \
 ## ASGI Apps
 
 #### To run contract tests with a stub for an asgi app (like sanic):
-- If you are using an asgi app like sanic, fastapi, use the ``````with_app_module`````` function and pass it a string in the 'module:app' format.
+- If you are using an asgi app like sanic, fastapi, use the ``````with_asgi_app`````` function and pass it a string in the 'module:app' format.
 ``````
 class TestContract:
     pass
@@ -102,9 +98,7 @@ class TestContract:
 Specmatic() \
     .with_project_root(PROJECT_ROOT) \
     .with_stub(stub_host, stub_port, [expectation_json_file]) \
-    .with_app_module('main:app') \
-    .with_app_host(app_host) \
-    .with_app_port(app_port) \
+    .with_asgi_app('main:app', app_host, app_port) \
     .test(TestContract) \
     .run()
 ``````
@@ -119,15 +113,14 @@ class TestContract:
 Specmatic() \
     .with_project_root(PROJECT_ROOT) \
     .with_stub(stub_host, stub_port, [expectation_json_file], ['--strict']) \
-    .with_app(app) \
-    .with_app_port(app_port) \
+    .with_wsgi_app(app, port=app_port) \
     .test(TestContract, args=['--testBaseURL=http://localhost:5000']) \
     .run()
 ``````
 
 ## Common Issues
 - **'Error loading ASGI app'** 
-   This error occurs due to incorrect module being specified in the app module parameter 'module:app' string.
+   This error occurs when an incorrect app module string is passed to the ``````with_asgi_app`````` function.  
  
    #### Solutions:
    - Try to identify the correct module in which your app variable is instantiated/imported.  

{specmatic-0.9.0.dist-info → specmatic-0.9.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
 specmatic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 specmatic/utils.py,sha256=6JDPqpO51ykl0MWCOa32jkUOXZ-0RZ6N5Ng9_7r7XaU,519
-specmatic/version.py,sha256=IRx7rPuv-0efdUmSFOrSIBjdwo_CCE56JFXc_0C53Qc,55
+specmatic/version.py,sha256=MpN_PFJMmvrp-2TOtwaw16FhamYEEkOXXdUWtIOP4YM,55
 specmatic/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 specmatic/core/decorators.py,sha256=_TWZMbUyH4WFyYHzW0oBcuef-c6ktukJ9Av3iYrDkTY,2879
 specmatic/core/specmatic.jar,sha256=LIHTAPFuGtfZ6zvcrwfVJ7luLAuSvMvDoalInN3pqUQ,87155557
-specmatic/core/specmatic.py,sha256=WlhEBf3nZ1T5Sg5hSFBkTnvnKqni_LQrnBIlXxxT4QY,5111
+specmatic/core/specmatic.py,sha256=avagtEtRnfxUFqwHR3q-vIB0YdypJTsWEmQVA6DPXQQ,5361
 specmatic/core/specmatic_base.py,sha256=sueXRmjXXLV8YC_3rsxGng2bPt2qWIsTWEO2A9MXMP0,1497
 specmatic/core/specmatic_stub.py,sha256=_I6jc8oI7me6Q64gtPchRRqA-c8GGO5YTCIpw1nrwEo,4563
 specmatic/core/specmatic_test.py,sha256=rZXCeTlH-3wkShJECL7VDN2hlkJgmuiKQYzVRwnLNok,994
@@ -14,10 +14,10 @@ specmatic/generators/test_generator_base.py,sha256=bCdJD9MOUX6FINPF2r06y9NQ5k10q
 specmatic/generators/unittest_generator.py,sha256=Vkm8BP-_rZ-tFbLwUTNc90OgQCMJ4OHd8w5mShhcFyU,713
 specmatic/servers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 specmatic/servers/app_server.py,sha256=kOZviJA7-F4kmMTLGiBln2oO5uYX28wKJM2xQJTOVQY,456
-specmatic/servers/asgi_app_server.py,sha256=mQ885snLeUUtb0mrDjLiT9CS-6MGVdFsCYEz9dAL51A,2743
+specmatic/servers/asgi_app_server.py,sha256=yn3tpWoF-nP8labOJdn49UB85vKiqIELVXk-gAugcUc,2924
 specmatic/servers/wsgi_app_server.py,sha256=3aU-o6Hh8FrnZlbjCLLpGY92HvJoU_rcqsZIb9TKVr8,1342
 specmatic/servers/wsgi_server_thread.py,sha256=XUEYW7-FP1a-5EkQVGc3FI_jkDQBocArxHLiCn3JJvc,691
-specmatic-0.9.0.dist-info/METADATA,sha256=yjeRIIIpM3wNdawz2Srkr32cbR-i_JgKAANZTQW7S1U,5842
-specmatic-0.9.0.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-specmatic-0.9.0.dist-info/top_level.txt,sha256=E7kQ78YacKBoKKeKWR_N83exlG8r5J0wlzlGqFmvIfo,10
-specmatic-0.9.0.dist-info/RECORD,,
+specmatic-0.9.1.dist-info/METADATA,sha256=OwazAuFZ4kT_CqWPPI914IixxOgtBreA9Ivspedn4d0,5717
+specmatic-0.9.1.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+specmatic-0.9.1.dist-info/top_level.txt,sha256=E7kQ78YacKBoKKeKWR_N83exlG8r5J0wlzlGqFmvIfo,10
+specmatic-0.9.1.dist-info/RECORD,,