appier 1.34.6__py2.py3-none-any.whl → 1.34.8__py2.py3-none-any.whl

appier/test/data.py

@@ -28,6 +28,8 @@ __copyright__ = "Copyright (c) 2008-2024 Hive Solutions Lda."
 __license__ = "Apache License, Version 2.0"
 """ The license for the module """
 
+import os
+import tempfile
 import unittest
 
 import appier
@@ -40,3 +42,11 @@ class DataTest(unittest.TestCase):
 
         self.assertEqual(type(identifier), str)
         self.assertEqual(len(identifier), 24)
+
+    def test_drop_db_missing(self):
+        fd, file_path = tempfile.mkstemp()
+        os.close(fd)
+        adapter = appier.TinyAdapter(file_path=file_path)
+        adapter.get_db()
+        os.remove(file_path)
+        adapter.drop_db()

appier/test/error_handler.py

@@ -0,0 +1,142 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Hive Appier Framework
+# Copyright (c) 2008-2024 Hive Solutions Lda.
+#
+# This file is part of Hive Appier Framework.
+#
+# Hive Appier Framework is free software: you can redistribute it and/or modify
+# it under the terms of the Apache License as published by the Apache
+# Foundation, either version 2.0 of the License, or (at your option) any
+# later version.
+#
+# Hive Appier Framework is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# Apache License for more details.
+#
+# You should have received a copy of the Apache License along with
+# Hive Appier Framework. If not, see <http://www.apache.org/licenses/>.
+
+__author__ = "João Magalhães <joamag@hive.pt>"
+""" The author(s) of the module """
+
+__copyright__ = "Copyright (c) 2008-2024 Hive Solutions Lda."
+""" The copyright for the module """
+
+__license__ = "Apache License, Version 2.0"
+""" The license for the module """
+
+import unittest
+
+import appier
+
+
+class ErrorHandlerTest(unittest.TestCase):
+    def setUp(self):
+        self._original_handlers = appier.common.base().App._ERROR_HANDLERS
+        appier.common.base().App._ERROR_HANDLERS = {}
+        self.app = appier.App()
+
+    def tearDown(self):
+        self.app.unload()
+        appier.common.base().App._ERROR_HANDLERS = self._original_handlers
+
+    def test_basic_registration_and_call(self):
+        """
+        Decorator should register the handler and it must be invoked by
+        :pyfunc:`appier.App.call_error` when an exception matching the provided
+        error code is raised.
+
+        The error handler is a JSON handler by default, to be able to properly
+        handle errors in an App.
+        """
+
+        @appier.error_handler(404, json=True)
+        def not_found(_):
+            return "resource not found"
+
+        exc = appier.exceptions.NotFoundError("dummy")
+        result = self.app.call_error(exc, code=exc.code, scope=None, json=True)
+        self.assertEqual(result, "resource not found")
+
+        handlers = appier.common.base().App._ERROR_HANDLERS.get(404)
+        self.assertNotEqual(handlers, None)
+        self.assertEqual(len(handlers), 1)
+
+        method, scope, json, opts, ctx, priority = handlers[0]
+        self.assertEqual(method, not_found)
+        self.assertEqual(scope, None)
+        self.assertEqual(json, True)
+        self.assertEqual(opts, None)
+        self.assertEqual(ctx, None)
+        self.assertEqual(priority, 1)
+
+    def test_web_handler(self):
+        """
+        Test that in which the error handler is a web handler by default, to be
+        able to properly handle errors in an WebApp, because this is a App no
+        handler is called.
+        """
+
+        @appier.error_handler(404, json=False)
+        def not_found(_):
+            return "resource not found"
+
+        exc = appier.exceptions.NotFoundError("dummy")
+        result = self.app.call_error(exc, code=exc.code, scope=None, json=True)
+        self.assertEqual(result, None)
+
+        handlers = appier.common.base().App._ERROR_HANDLERS.get(404)
+        self.assertNotEqual(handlers, None)
+        self.assertEqual(len(handlers), 1)
+
+        method, scope, json, opts, ctx, priority = handlers[0]
+        self.assertEqual(method, not_found)
+        self.assertEqual(scope, None)
+        self.assertEqual(json, False)
+        self.assertEqual(opts, None)
+        self.assertEqual(ctx, None)
+        self.assertEqual(priority, 1)
+
+    def test_scope_registration(self):
+        """
+        When a *scope* argument is provided, it should be stored in the handler
+        metadata so that the framework can later match it appropriately.
+
+        The error handler is a JSON handler by default, to be able to properly
+        handle errors in an App.
+        """
+
+        class DummyScope:
+            pass
+
+        class DummyException(Exception):
+            code = 400
+
+        @appier.error_handler(400, scope=DummyScope)
+        def bad_request(_):
+            return "bad request"
+
+        exc = DummyException("dummy")
+        result = self.app.call_error(exc, code=exc.code, scope=DummyScope, json=True)
+        self.assertEqual(result, "bad request")
+
+        result = None
+        exc = DummyException("dummy")
+        result = self.app.call_error(exc, code=exc.code, json=True)
+        self.assertEqual(result, None)
+
+        handlers = appier.common.base().App._ERROR_HANDLERS.get(400)
+        self.assertNotEqual(handlers, None)
+        self.assertEqual(len(handlers), 1)
+
+        method, scope, json, opts, ctx, priority = handlers[0]
+
+        self.assertEqual(method, bad_request)
+        self.assertEqual(scope, DummyScope)
+        self.assertEqual(json, None)
+        self.assertEqual(opts, None)
+        self.assertEqual(ctx, None)
+        self.assertEqual(priority, 1)

appier/test/exception_handler.py

@@ -0,0 +1,146 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Hive Appier Framework
+# Copyright (c) 2008-2024 Hive Solutions Lda.
+#
+# This file is part of Hive Appier Framework.
+#
+# Hive Appier Framework is free software: you can redistribute it and/or modify
+# it under the terms of the Apache License as published by the Apache
+# Foundation, either version 2.0 of the License, or (at your option) any
+# later version.
+#
+# Hive Appier Framework is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# Apache License for more details.
+#
+# You should have received a copy of the Apache License along with
+# Hive Appier Framework. If not, see <http://www.apache.org/licenses/>.
+
+__author__ = "João Magalhães <joamag@hive.pt>"
+""" The author(s) of the module """
+
+__copyright__ = "Copyright (c) 2008-2024 Hive Solutions Lda."
+""" The copyright for the module """
+
+__license__ = "Apache License, Version 2.0"
+""" The license for the module """
+
+import unittest
+
+import appier
+
+
+class ExceptionHandlerTest(unittest.TestCase):
+    def setUp(self):
+        self._original_handlers = appier.common.base().App._ERROR_HANDLERS
+        appier.common.base().App._ERROR_HANDLERS = {}
+        self.app = appier.App()
+
+    def tearDown(self):
+        self.app.unload()
+        appier.common.base().App._ERROR_HANDLERS = self._original_handlers
+
+    def test_basic_registration_and_call(self):
+        """
+        Decorator should register the handler and it must be invoked by
+        :pyfunc:`appier.App.call_error` when an exception matching the provided
+        type is raised.
+
+        The exception handler is a JSON handler by default, to be able to properly
+        handle errors in an App.
+        """
+
+        @appier.exception_handler(appier.exceptions.NotFoundError, json=True)
+        def not_found(_):
+            return "resource not found"
+
+        exc = appier.exceptions.NotFoundError("dummy")
+        result = self.app.call_error(exc, scope=None, json=True)
+        self.assertEqual(result, "resource not found")
+
+        handlers = appier.common.base().App._ERROR_HANDLERS.get(
+            appier.exceptions.NotFoundError
+        )
+        self.assertNotEqual(handlers, None)
+        self.assertEqual(len(handlers), 1)
+
+        method, scope, json, opts, ctx, priority = handlers[0]
+        self.assertEqual(method, not_found)
+        self.assertEqual(scope, None)
+        self.assertEqual(json, True)
+        self.assertEqual(opts, None)
+        self.assertEqual(ctx, None)
+        self.assertEqual(priority, 1)
+
+    def test_web_handler(self):
+        """
+        Test that in which the exception handler is a web handler by default, to be
+        able to properly handle errors in an WebApp, because this is an App no
+        handler is called.
+        """
+
+        @appier.exception_handler(appier.exceptions.NotFoundError, json=False)
+        def not_found(_):
+            return "resource not found"
+
+        exc = appier.exceptions.NotFoundError("dummy")
+        result = self.app.call_error(exc, scope=None, json=True)
+        self.assertEqual(result, None)
+
+        handlers = appier.common.base().App._ERROR_HANDLERS.get(
+            appier.exceptions.NotFoundError
+        )
+        self.assertNotEqual(handlers, None)
+        self.assertEqual(len(handlers), 1)
+
+        method, scope, json, opts, ctx, priority = handlers[0]
+        self.assertEqual(method, not_found)
+        self.assertEqual(scope, None)
+        self.assertEqual(json, False)
+        self.assertEqual(opts, None)
+        self.assertEqual(ctx, None)
+        self.assertEqual(priority, 1)
+
+    def test_scope_registration(self):
+        """
+        When a *scope* argument is provided, it should be stored in the handler
+        metadata so that the framework can later match it appropriately.
+
+        The exception handler is a JSON handler by default, to be able to properly
+        handle errors in an App.
+        """
+
+        class DummyScope:
+            pass
+
+        class DummyException(Exception):
+            code = 400
+
+        @appier.exception_handler(DummyException, scope=DummyScope)
+        def bad_request(_):
+            return "bad request"
+
+        exc = DummyException("dummy")
+        result = self.app.call_error(exc, scope=DummyScope, json=True)
+        self.assertEqual(result, "bad request")
+
+        result = None
+        exc = DummyException("dummy")
+        result = self.app.call_error(exc, json=True)
+        self.assertEqual(result, None)
+
+        handlers = appier.common.base().App._ERROR_HANDLERS.get(DummyException)
+        self.assertNotEqual(handlers, None)
+        self.assertEqual(len(handlers), 1)
+
+        method, scope, json, opts, ctx, priority = handlers[0]
+
+        self.assertEqual(method, bad_request)
+        self.assertEqual(scope, DummyScope)
+        self.assertEqual(json, None)
+        self.assertEqual(opts, None)
+        self.assertEqual(ctx, None)
+        self.assertEqual(priority, 1)

appier/test/http.py

@@ -104,6 +104,9 @@ class HTTPTest(unittest.TestCase):
         self.assertEqual(params, dict(hello=["world"]))
 
     def test_redirect(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         _data, response = appier.get(
             "https://%s/redirect-to" % self.httpbin,
             params=dict(url="https://%s/" % self.httpbin),
@@ -135,6 +138,9 @@ class HTTPTest(unittest.TestCase):
         self.assertEqual(code, 200)
 
     def test_timeout(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         self.assertRaises(
             BaseException,
             lambda: appier.get(
@@ -155,6 +161,9 @@ class HTTPTest(unittest.TestCase):
         self.assertNotEqual(data, None)
 
     def test_get_f(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         file = appier.get_f("https://%s/image/png" % self.httpbin)
 
         self.assertEqual(file.file_name, "default")
@@ -170,6 +179,9 @@ class HTTPTest(unittest.TestCase):
         self.assertEqual(len(file.data_b64) > 100, True)
 
     def test_generator(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         def text_g(message=[b"hello", b" ", b"world"]):
             yield sum(len(value) for value in message)
             for value in message:
@@ -185,6 +197,9 @@ class HTTPTest(unittest.TestCase):
         self.assertEqual(data["data"], "hello world")
 
     def test_file(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         data, response = appier.post(
             "https://%s/post" % self.httpbin,
             data=appier.legacy.BytesIO(b"hello world"),
@@ -198,6 +213,9 @@ class HTTPTest(unittest.TestCase):
         self.assertEqual(data["data"], "hello world")
 
     def test_multithread(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         threads = []
         results = []
 
@@ -230,11 +248,17 @@ class HTTPTest(unittest.TestCase):
             self.assertEqual(code, 200)
 
     def test_error(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         self.assertRaises(
             appier.HTTPError, lambda: appier.get("https://%s/status/404" % self.httpbin)
         )
 
     def test_invalid(self):
+        if appier.conf("NO_NETWORK", False, cast=bool):
+            self.skipTest("Network access is disabled")
+
         self.assertRaises(
             BaseException, lambda: appier.get("https://invalidlargedomain.org/")
         )

appier/test/tags.py

@@ -0,0 +1,109 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+# Hive Appier Framework
+# Copyright (c) 2008-2024 Hive Solutions Lda.
+#
+# This file is part of Hive Appier Framework.
+#
+# Hive Appier Framework is free software: you can redistribute it and/or modify
+# it under the terms of the Apache License as published by the Apache
+# Foundation, either version 2.0 of the License, or (at your option) any
+# later version.
+#
+# Hive Appier Framework is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# Apache License for more details.
+#
+# You should have received a copy of the Apache License along with
+# Hive Appier Framework. If not, see <http://www.apache.org/licenses/>.
+
+__author__ = "João Magalhães <joamag@hive.pt>"
+""" The author(s) of the module """
+
+__copyright__ = "Copyright (c) 2008-2024 Hive Solutions Lda."
+""" The copyright for the module """
+
+__license__ = "Apache License, Version 2.0"
+""" The license for the module """
+
+import unittest
+
+import appier
+
+
+class TagsTest(unittest.TestCase):
+    def setUp(self):
+        self.app = appier.App()
+
+    def tearDown(self):
+        self.app.unload()
+
+    def test_script_tag(self):
+        if not self.app.jinja:
+            if not hasattr(self, "skipTest"):
+                return
+            self.skipTest("No Jinja2 template engine present")
+
+        template = appier.Template("{{ value|script_tag }}")
+        result = self.app.template(template, value="/static/app.js")
+        self.assertEqual(
+            result, '<script type="text/javascript" src="/static/app.js"></script>'
+        )
+
+        template = appier.Template("{{ '/static/app.js'|script_tag }}")
+        result = self.app.template(template)
+        self.assertEqual(
+            result, '<script type="text/javascript" src="/static/app.js"></script>'
+        )
+
+    def test_css_tag(self):
+        if not self.app.jinja:
+            if not hasattr(self, "skipTest"):
+                return
+            self.skipTest("No Jinja2 template engine present")
+
+        template = appier.Template("{{ value|css_tag }}")
+        result = self.app.template(template, value="/static/style.css")
+        self.assertEqual(
+            result, '<link rel="stylesheet" type="text/css" href="/static/style.css" />'
+        )
+
+        template = appier.Template("{{ '/static/style.css'|css_tag }}")
+        result = self.app.template(template)
+        self.assertEqual(
+            result, '<link rel="stylesheet" type="text/css" href="/static/style.css" />'
+        )
+
+    def test_stylesheet_tag(self):
+        if not self.app.jinja:
+            if not hasattr(self, "skipTest"):
+                return
+            self.skipTest("No Jinja2 template engine present")
+
+        template = appier.Template("{{ value|stylesheet_tag }}")
+        result = self.app.template(template, value="/static/main.css")
+        self.assertEqual(
+            result, '<link rel="stylesheet" type="text/css" href="/static/main.css" />'
+        )
+
+        template = appier.Template("{{ '/static/main.css'|stylesheet_tag }}")
+        result = self.app.template(template)
+        self.assertEqual(
+            result, '<link rel="stylesheet" type="text/css" href="/static/main.css" />'
+        )
+
+    def test_asset_url(self):
+        if not self.app.jinja:
+            if not hasattr(self, "skipTest"):
+                return
+            self.skipTest("No Jinja2 template engine present")
+
+        template = appier.Template("{{ filename|asset_url }}")
+        result = self.app.template(template, filename="logo.png")
+        self.assertEqual(result, "/static/assets/logo.png")
+
+        template = appier.Template("{{ 'logo.png'|asset_url }}")
+        result = self.app.template(template)
+        self.assertEqual(result, "/static/assets/logo.png")