appier 1.31.4__py2.py3-none-any.whl → 1.32.0__py2.py3-none-any.whl

appier/__init__.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 
 # Hive Appier Framework
-# Copyright (c) 2008-2022 Hive Solutions Lda.
+# Copyright (c) 2008-2024 Hive Solutions Lda.
 #
 # This file is part of Hive Appier Framework.
 #
@@ -19,16 +19,7 @@
 # You should have received a copy of the Apache License along with
 # Hive Appier Framework. If not, see <http://www.apache.org/licenses/>.
 
-__version__ = "1.0.0"
-""" The version of the module """
-
-__revision__ = "$LastChangedRevision$"
-""" The revision number of the module """
-
-__date__ = "$LastChangedDate$"
-""" The last change date of the module """
-
-__copyright__ = "Copyright (c) 2008-2022 Hive Solutions Lda."
+__copyright__ = "Copyright (c) 2008-2024 Hive Solutions Lda."
 """ The copyright for the module """
 
 __license__ = "Apache License, Version 2.0"
@@ -80,14 +71,75 @@ from . import validation
 
 from .amqp import AMQP
 from .api import API, OAuthAPI, OAuth1API, OAuth2API
-from .asynchronous import ASYNC_HEADER, AsyncManager, SimpleManager, QueueManager, AwaitWrapper, CoroutineWrapper,\
-    AyncgenWrapper, await_wrap, await_yield, ensure_generator, is_coroutine, is_coroutine_object, is_coroutine_native,\
-    to_coroutine, wrap_silent, unavailable, is_neo, Future, coroutine, wakeup, sleep, wait, notify, build_future,\
-    ensure_async, header_a, ensure_a
-from .base import APP, LEVEL, NAME, VERSION, PLATFORM, IDENTIFIER_SHORT, IDENTIFIER_LONG, IDENTIFIER,\
-    API_VERSION, BUFFER_SIZE, MAX_LOG_SIZE, MAX_LOG_COUNT, App, APIApp, WebApp, Template, get_app, get_name,\
-    get_base_path, get_cache, get_preferences, get_bus, get_request, get_session, get_model, get_controller, get_part,\
-    get_adapter, get_manager, get_logger, get_level, is_loaded, is_devel, is_safe, to_locale, on_exit, build_asgi, build_asgi_i
+from .asynchronous import (
+    ASYNC_HEADER,
+    AsyncManager,
+    SimpleManager,
+    QueueManager,
+    AwaitWrapper,
+    CoroutineWrapper,
+    AyncgenWrapper,
+    await_wrap,
+    await_yield,
+    ensure_generator,
+    is_coroutine,
+    is_coroutine_object,
+    is_coroutine_native,
+    to_coroutine,
+    wrap_silent,
+    unavailable,
+    is_neo,
+    Future,
+    coroutine,
+    wakeup,
+    sleep,
+    wait,
+    notify,
+    build_future,
+    ensure_async,
+    header_a,
+    ensure_a,
+)
+from .base import (
+    APP,
+    LEVEL,
+    NAME,
+    VERSION,
+    PLATFORM,
+    IDENTIFIER_SHORT,
+    IDENTIFIER_LONG,
+    IDENTIFIER,
+    API_VERSION,
+    BUFFER_SIZE,
+    MAX_LOG_SIZE,
+    MAX_LOG_COUNT,
+    App,
+    APIApp,
+    WebApp,
+    Template,
+    get_app,
+    get_name,
+    get_base_path,
+    get_cache,
+    get_preferences,
+    get_bus,
+    get_request,
+    get_session,
+    get_model,
+    get_controller,
+    get_part,
+    get_adapter,
+    get_manager,
+    get_logger,
+    get_level,
+    is_loaded,
+    is_devel,
+    is_safe,
+    to_locale,
+    on_exit,
+    build_asgi,
+    build_asgi_i,
+)
 from .bus import Bus, MemoryBus, RedisBus
 from .cache import Cache, MemoryCache, FileCache, RedisCache, SerializedCache
 from .component import Component
@@ -95,56 +147,285 @@ from .compress import Compress
 from .config import conf, conf_prefix, conf_suffix, conf_s, conf_r, conf_d, conf_ctx
 from .controller import Controller
 from .crypt import Cipher, RC4, Spritz
-from .data import DataAdapter, MongoAdapter, TinyAdapter, Collection, MongoCollection, TinyCollection
-from .defines import ITERABLES, MOBILE_REGEX, TABLET_REGEX, MOBILE_PREFIX_REGEX, BODY_REGEX, TAG_REGEX,\
-    EMAIL_REGEX, BROWSER_INFO, OS_INFO, WINDOWS_LOCALE, SLUG_PERMUTATIONS
-from .exceptions import AppierException, OperationalError, SecurityError, AssertionError,\
-    ValidationError, NotFoundError, NotImplementedError, BaseInternalError, ValidationInternalError,\
-    ValidationMultipleError, HTTPError, APIError, APIAccessError, OAuthAccessError
-from .execution import ExecutionThread, background, insert_work, interval_work, seconds_work,\
-    minutes_work, hourly_work, daily_work, weekly_work, monthly_work, seconds_eval, minutes_eval,\
-    hourly_eval, daily_eval, weekly_eval, monthly_eval
+from .data import (
+    DataAdapter,
+    MongoAdapter,
+    TinyAdapter,
+    Collection,
+    MongoCollection,
+    TinyCollection,
+)
+from .defines import (
+    ITERABLES,
+    MOBILE_REGEX,
+    TABLET_REGEX,
+    MOBILE_PREFIX_REGEX,
+    BODY_REGEX,
+    TAG_REGEX,
+    EMAIL_REGEX,
+    BROWSER_INFO,
+    OS_INFO,
+    WINDOWS_LOCALE,
+    SLUG_PERMUTATIONS,
+)
+from .exceptions import (
+    AppierException,
+    OperationalError,
+    SecurityError,
+    AssertionError,
+    ValidationError,
+    NotFoundError,
+    NotImplementedError,
+    BaseInternalError,
+    ValidationInternalError,
+    ValidationMultipleError,
+    HTTPError,
+    APIError,
+    APIAccessError,
+    OAuthAccessError,
+)
+from .execution import (
+    ExecutionThread,
+    background,
+    insert_work,
+    interval_work,
+    seconds_work,
+    minutes_work,
+    hourly_work,
+    daily_work,
+    weekly_work,
+    monthly_work,
+    seconds_eval,
+    minutes_eval,
+    hourly_eval,
+    daily_eval,
+    weekly_eval,
+    monthly_eval,
+)
 from .export import ExportManager
-from .extra import get_a, post_a, put_a, delete_a, patch_a, get_w, post_w, put_w, delete_w, patch_w
+from .extra import (
+    get_a,
+    post_a,
+    put_a,
+    delete_a,
+    patch_a,
+    get_w,
+    post_w,
+    put_w,
+    delete_w,
+    patch_w,
+)
 from .geo import GeoResolver
 from .git import Git
 from .graph import Graph
 from .http import file_g, get_f, get, post, put, delete, patch, basic_auth, HTTPResponse
-from .log import MemoryHandler, BaseFormatter, ThreadFormatter, DummyLogger, reload_format, rotating_handler,\
-    smtp_handler, in_signature
+from .log import (
+    MemoryHandler,
+    BaseFormatter,
+    ThreadFormatter,
+    DummyLogger,
+    reload_format,
+    rotating_handler,
+    smtp_handler,
+    in_signature,
+)
 from .meta import Ordered, Indexed
 from .mock import MockObject, MockResponse, MockApp
-from .model import Model, LocalModel, Field, link, operation, view, field, type_d, is_unset
-from .mongo import Mongo, MongoAsync, MongoEncoder, get_connection, get_connection_a, reset_connection, reset_connection_a,\
-    get_db, get_db_a, drop_db, drop_db_a, object_id, dumps
+from .model import (
+    Model,
+    LocalModel,
+    Field,
+    link,
+    operation,
+    view,
+    field,
+    type_d,
+    is_unset,
+)
+from .mongo import (
+    Mongo,
+    MongoAsync,
+    MongoEncoder,
+    get_connection,
+    get_connection_a,
+    reset_connection,
+    reset_connection_a,
+    get_db,
+    get_db_a,
+    drop_db,
+    drop_db_a,
+    object_id,
+    dumps,
+)
 from .observer import Observable
 from .part import Part
-from .preferences import Preferences, MemoryPreferences, FilePreferences, RedisPreferences
+from .preferences import (
+    Preferences,
+    MemoryPreferences,
+    FilePreferences,
+    RedisPreferences,
+)
 from .queuing import Queue, MemoryQueue, MultiprocessQueue, AMQPQueue
 from .redisdb import Redis
 from .request import CODE_STRINGS, Request, MockRequest
 from .scheduler import Scheduler
 from .serialize import serialize_csv, serialize_ics, build_encoder
-from .session import Session, MockSession, MemorySession, FileSession, RedisSession, ClientSession
+from .session import (
+    Session,
+    MockSession,
+    MemorySession,
+    FileSession,
+    RedisSession,
+    ClientSession,
+)
 from .settings import DEBUG, USERNAME, PASSWORD
-from .smtp import message, message_base, message_netius, smtp_engine, multipart, plain,\
-    html, application, header
+from .smtp import (
+    message,
+    message_base,
+    message_netius,
+    smtp_engine,
+    multipart,
+    plain,
+    html,
+    application,
+    header,
+)
 from .storage import StorageEngine, BaseEngine, FsEngine
 from .structures import OrderedDict, LazyDict, LazyValue, GeneratorFile, lazy_dict, lazy
-from .typesf import AbstractType, Type, File, Files, ImageFile, ImageFiles, image, images, Reference,\
-    reference, References, references, Encrypted, encrypted, secure
-from .util import to_limit, to_find, to_sort, is_iterable, is_mobile, is_tablet, is_browser, is_bot, browser_info,\
-    email_parts, email_mime, email_name, email_base, date_to_timestamp, obfuscate, import_pip, ensure_pip, install_pip,\
-    install_pip_s, request_json, get_context, get_object, resolve_alias, page_types, find_types, norm_object, set_object, leafs,\
-    gather_errors, gen_token, html_to_text, camel_to_underscore, camel_to_readable, underscore_to_camel, underscore_to_readable, quote,\
-    unquote, escape, unescape, count_unescape, split_unescape, call_safe, base_name, base_name_m, is_content_type, parse_content_type,\
-    parse_cookie, parse_multipart, decode_params, load_form, check_login, check_user, check_token, check_tokens,\
-    ensure_login, get_tokens_m, to_tokens_m, dict_merge, deprecated, cached, private, ensure, delayed, route, error_handler,\
-    exception_handler, before_request, after_request, is_detached, sanitize, verify, verify_equal, verify_not_equal,\
-    verify_type, verify_many, execute, ctx_locale, ctx_request, FileTuple, BaseThread, JSONEncoder
-from .validation import validate, validate_b, validate_e, safe, eq, gt, gte, lt, lte, not_null, not_empty, not_false,\
-    is_in, is_upper, is_lower, is_simple, is_email, is_url, is_regex, field_eq, field_gt, field_gte, field_lt,\
-    field_lte, string_gt, string_lt, string_eq, equals, not_past, not_duplicate, all_different, no_self
+from .typesf import (
+    AbstractType,
+    Type,
+    File,
+    Files,
+    ImageFile,
+    ImageFiles,
+    image,
+    images,
+    Reference,
+    reference,
+    References,
+    references,
+    Encrypted,
+    encrypted,
+    secure,
+)
+from .util import (
+    to_limit,
+    to_find,
+    to_sort,
+    is_iterable,
+    is_mobile,
+    is_tablet,
+    is_browser,
+    is_bot,
+    browser_info,
+    email_parts,
+    email_mime,
+    email_name,
+    email_base,
+    date_to_timestamp,
+    obfuscate,
+    import_pip,
+    ensure_pip,
+    install_pip,
+    install_pip_s,
+    request_json,
+    get_context,
+    get_object,
+    resolve_alias,
+    page_types,
+    find_types,
+    norm_object,
+    set_object,
+    leafs,
+    gather_errors,
+    gen_token,
+    html_to_text,
+    camel_to_underscore,
+    camel_to_readable,
+    underscore_to_camel,
+    underscore_to_readable,
+    quote,
+    unquote,
+    escape,
+    unescape,
+    count_unescape,
+    split_unescape,
+    call_safe,
+    base_name,
+    base_name_m,
+    is_content_type,
+    parse_content_type,
+    parse_cookie,
+    parse_multipart,
+    decode_params,
+    load_form,
+    check_login,
+    check_user,
+    check_token,
+    check_tokens,
+    ensure_login,
+    get_tokens_m,
+    to_tokens_m,
+    dict_merge,
+    deprecated,
+    cached,
+    private,
+    ensure,
+    delayed,
+    route,
+    error_handler,
+    exception_handler,
+    before_request,
+    after_request,
+    is_detached,
+    sanitize,
+    verify,
+    verify_equal,
+    verify_not_equal,
+    verify_type,
+    verify_many,
+    execute,
+    ctx_locale,
+    ctx_request,
+    FileTuple,
+    BaseThread,
+    JSONEncoder,
+)
+from .validation import (
+    validate,
+    validate_b,
+    validate_e,
+    safe,
+    eq,
+    gt,
+    gte,
+    lt,
+    lte,
+    not_null,
+    not_empty,
+    not_false,
+    is_in,
+    is_upper,
+    is_lower,
+    is_simple,
+    is_email,
+    is_url,
+    is_regex,
+    field_eq,
+    field_gt,
+    field_gte,
+    field_lt,
+    field_lte,
+    string_gt,
+    string_lt,
+    string_eq,
+    equals,
+    not_past,
+    not_duplicate,
+    all_different,
+    no_self,
+)
 
 from .amqp import get_connection as get_amqp
 from .amqp import properties as properties_amqp

appier/amqp.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 
 # Hive Appier Framework
-# Copyright (c) 2008-2022 Hive Solutions Lda.
+# Copyright (c) 2008-2024 Hive Solutions Lda.
 #
 # This file is part of Hive Appier Framework.
 #
@@ -22,16 +22,7 @@
 __author__ = "João Magalhães <joamag@hive.pt>"
 """ The author(s) of the module """
 
-__version__ = "1.0.0"
-""" The version of the module """
-
-__revision__ = "$LastChangedRevision$"
-""" The revision number of the module """
-
-__date__ = "$LastChangedDate$"
-""" The last change date of the module """
-
-__copyright__ = "Copyright (c) 2008-2022 Hive Solutions Lda."
+__copyright__ = "Copyright (c) 2008-2024 Hive Solutions Lda."
 """ The copyright for the module """
 
 __license__ = "Apache License, Version 2.0"
@@ -42,8 +33,10 @@ from . import config
 from . import legacy
 from . import exceptions
 
-try: import pika
-except ImportError: pika = None
+try:
+    import pika
+except ImportError:
+    pika = None
 
 URL = "amqp://guest:guest@localhost"
 """ The default URL to be used for the connection when
@@ -58,14 +51,15 @@ connection = None
 """ The global wide connection to the AMQP server
 that is meant to be used across sessions """
 
-class AMQP(object):
 
-    def __init__(self, url = None):
+class AMQP(object):
+    def __init__(self, url=None):
         self.url = url
         self._connection = None
 
-    def get_connection(self, url = None, timeout = TIMEOUT):
-        if self._connection: return self._connection
+    def get_connection(self, url=None, timeout=TIMEOUT):
+        if self._connection:
+            return self._connection
         url_c = config.conf("AMQP_URL", None)
         url_c = config.conf("CLOUDAMQP_URL", url_c)
         url_c = config.conf("RABBITMQ_URL", url_c)
@@ -74,34 +68,37 @@ class AMQP(object):
         username = "guest" if url_p.username == None else url_p.username
         password = "guest" if url_p.password == None else url_p.password
         parameters = _pika().ConnectionParameters(
-            host = url_p.hostname,
-            virtual_host = url_p.path or "/",
-            credentials = _pika().PlainCredentials(username, password)
+            host=url_p.hostname,
+            virtual_host=url_p.path or "/",
+            credentials=_pika().PlainCredentials(username, password),
         )
         parameters.socket_timeout = timeout
         self._connection = _pika().BlockingConnection(parameters)
         self._connection = _set_fixes(self._connection)
         return self._connection
 
-def get_connection(url = URL, timeout = TIMEOUT):
+
+def get_connection(url=URL, timeout=TIMEOUT):
     global connection
     url = config.conf("AMQP_URL", url)
     url = config.conf("CLOUDAMQP_URL", url)
     url = config.conf("RABBITMQ_URL", url)
     url_p = legacy.urlparse(url)
     parameters = _pika().ConnectionParameters(
-        host = url_p.hostname,
-        virtual_host = url_p.path or "/",
-        credentials = _pika().PlainCredentials(url_p.username, url_p.password)
+        host=url_p.hostname,
+        virtual_host=url_p.path or "/",
+        credentials=_pika().PlainCredentials(url_p.username, url_p.password),
     )
     parameters.socket_timeout = timeout
     connection = _pika().BlockingConnection(parameters)
     connection = _set_fixes(connection)
     return connection
 
+
 def properties(*args, **kwargs):
     return _pika().BasicProperties(*args, **kwargs)
 
+
 def _set_fixes(connection):
     def disconnect():
         connection.socket.close()
@@ -110,10 +107,12 @@ def _set_fixes(connection):
         connection.disconnect = disconnect
     return connection
 
-def _pika(verify = True):
-    if verify: util.verify(
-        not pika == None,
-        message = "Pika library not available",
-        exception = exceptions.OperationalError
-    )
+
+def _pika(verify=True):
+    if verify:
+        util.verify(
+            not pika == None,
+            message="Pika library not available",
+            exception=exceptions.OperationalError,
+        )
     return pika