arthexis 0.1.3__py3-none-any.whl

arthexis-0.1.3.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: arthexis
+Version: 0.1.3
+Summary: Django-based MESH system
+Author-email: "Rafael J. Guillén-Osorio" <tecnologia@gelectriic.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/arthexis/arthexis
+Project-URL: Homepage, https://arthexis.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: amqp==5.3.1
+Requires-Dist: annotated-types==0.7.0
+Requires-Dist: anyio==4.9.0
+Requires-Dist: asgiref==3.9.1
+Requires-Dist: atproto==0.0.61
+Requires-Dist: attrs==25.3.0
+Requires-Dist: autobahn==24.4.2
+Requires-Dist: Automat==25.4.16
+Requires-Dist: billiard==4.2.1
+Requires-Dist: bleach==6.2.0
+Requires-Dist: celery==5.5.3
+Requires-Dist: certifi==2025.7.14
+Requires-Dist: cffi==1.17.1
+Requires-Dist: channels==4.1.0
+Requires-Dist: charset-normalizer==3.4.2
+Requires-Dist: click==8.2.1
+Requires-Dist: click-didyoumean==0.3.1
+Requires-Dist: click-plugins==1.1.1.2
+Requires-Dist: click-repl==0.3.0
+Requires-Dist: colorama==0.4.6
+Requires-Dist: constantly==23.10.4
+Requires-Dist: cron-descriptor==1.4.5
+Requires-Dist: cryptography==45.0.5
+Requires-Dist: daphne==4.2.1
+Requires-Dist: diff-match-patch==20241021
+Requires-Dist: Django==5.2.4
+Requires-Dist: django-celery-beat==2.8.1
+Requires-Dist: django-debug-toolbar==6.0.0
+Requires-Dist: django-import-export==4.3.9
+Requires-Dist: django-object-actions==5.0.0
+Requires-Dist: django-post_office==3.10.1
+Requires-Dist: django-timezone-field==7.1
+Requires-Dist: dnspython==2.7.0
+Requires-Dist: docutils==0.22
+Requires-Dist: gpiozero==2.0.1; sys_platform == "linux"
+Requires-Dist: h11==0.16.0
+Requires-Dist: httpcore==1.0.9
+Requires-Dist: httpx==0.28.1
+Requires-Dist: hyperlink==21.0.0
+Requires-Dist: idna==3.10
+Requires-Dist: incremental==24.7.2
+Requires-Dist: kombu==5.5.4
+Requires-Dist: libipld==3.1.1
+Requires-Dist: Markdown==3.8.2
+Requires-Dist: mfrc522==0.0.7; sys_platform == "linux"
+Requires-Dist: outcome==1.3.0.post0
+Requires-Dist: packaging==25.0
+Requires-Dist: pillow==11.3.0
+Requires-Dist: prompt_toolkit==3.0.51
+Requires-Dist: psycopg==3.2.9
+Requires-Dist: psycopg-binary==3.2.9
+Requires-Dist: pyasn1==0.6.1
+Requires-Dist: pyasn1_modules==0.4.2
+Requires-Dist: pycparser==2.22
+Requires-Dist: pydantic==2.11.7
+Requires-Dist: pydantic_core==2.33.2
+Requires-Dist: pyOpenSSL==25.1.0
+Requires-Dist: pyperclip==1.9.0
+Requires-Dist: PySocks==1.7.1
+Requires-Dist: python-crontab==3.3.0
+Requires-Dist: python-dateutil==2.9.0.post0
+Requires-Dist: python-dotenv==1.1.1
+Requires-Dist: qrcode==8.2
+Requires-Dist: redis==5.0.8
+Requires-Dist: requests==2.32.4
+Requires-Dist: selenium==4.34.2
+Requires-Dist: service-identity==24.2.0
+Requires-Dist: setuptools==80.9.0
+Requires-Dist: six==1.17.0
+Requires-Dist: smbus2==0.5.0
+Requires-Dist: sniffio==1.3.1
+Requires-Dist: sortedcontainers==2.4.0
+Requires-Dist: sqlparse==0.5.3
+Requires-Dist: tablib==3.8.0
+Requires-Dist: tinycss2==1.4.0
+Requires-Dist: toml==0.10.2
+Requires-Dist: trio==0.30.0
+Requires-Dist: trio-websocket==0.12.2
+Requires-Dist: Twisted==25.5.0
+Requires-Dist: twine==6.1.0
+Requires-Dist: txaio==25.6.1
+Requires-Dist: typing-inspection==0.4.1
+Requires-Dist: typing_extensions==4.14.1
+Requires-Dist: tzdata==2025.2
+Requires-Dist: urllib3==2.5.0
+Requires-Dist: vine==5.1.0
+Requires-Dist: wcwidth==0.2.13
+Requires-Dist: webencodings==0.5.1
+Requires-Dist: websocket-client==1.8.0
+Requires-Dist: websockets==13.1
+Requires-Dist: plyer==2.1.0; sys_platform == "win32"
+Requires-Dist: wsproto==1.2.0
+Requires-Dist: zope.interface==7.2
+Dynamic: license-file
+
+# Arthexis Constellation
+
+## Purpose
+Arthexis Constellation is a narrative-driven Django-based suite that centralizes tools for managing charging infrastructure and orchestrating energy related products and services.
+
+## Features
+- Compatibility with all OCPP 1.6 certified chargers
+- Native API integration with Odoo 1.6-based CRMs
+- Runs everywhere Python 3.10+ is installed
+- Single codebase with special features per role
+
+## Support
+You may contact us at tecnologia at gelectriic dot com or visit our web page https://www.gelectriic.com/ for professional services and commercial support.
+
+## About Me
+> "What? You want to know about me too? Well, I enjoy developing software, roleplaying games, long walks on the beach and a fourth secret thing."
+> --Arthexis
+

arthexis-0.1.3.dist-info/RECORD

@@ -0,0 +1,73 @@
+arthexis-0.1.3.dist-info/licenses/LICENSE,sha256=rBjcKtvD5yIpzAnkw3XRofK8KCAeL43DXmNaiRuYJrg,1092
+config/__init__.py,sha256=5EyLFDrM6aTOHSnyBcLXRvMInZMPmAAy9Icu0cHHK5o,110
+config/active_app.py,sha256=MET_G7oHL7GkoSo3VkkMzymM-PwsSZazMLZxpgjFLTo,388
+config/asgi.py,sha256=n09URedOmQ_59II3UCl3iodGSDWOuN_A8DFyfLjuylA,803
+config/auth_app.py,sha256=65cHsGtnwa0Q7-IjWIwJ73Kq4FpEcxSjHH_fu9Dr868,207
+config/celery.py,sha256=BSkOFmvaCz36BMTo9iSSg2mvTvIxVqV6pU_UVRH8h4U,434
+config/context_processors.py,sha256=_oQ5F8MZpAuv2QZl5QHoobEwTharl1lC7SRCUEmf3cQ,2341
+config/loadenv.py,sha256=bhFbHTbRJSkSwrFk3UInKEKQ8ZY-poatOGi7rC57YAI,298
+config/logging.py,sha256=KtQJi8CzE0EYTS9ptv2CyXHOz2TL10cD6GOnWzSqiXs,1559
+config/middleware.py,sha256=EvraDumepnKwCDswHGXb1mK7vud_dEEoZ4eh0IQ7fhQ,744
+config/offline.py,sha256=7XHGFlV7IAWUJ93dEjknrHkAHDEyzWxK_hj_ht4-6-Q,1427
+config/settings.py,sha256=1Ix8ee5S6SP7z51sLK5g3ejNr524xEJj_0LpeJsICuI,10854
+config/urls.py,sha256=mgC0PqY1JBH6GdOxM6A_p5rDzx9vDoEVAOrH36DWSB4,2991
+config/wsgi.py,sha256=Fu-ONO2SgYeU6rhmy909P-uLX-n8ALJQObdm9MHPS-k,450
+core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+core/admin.py,sha256=Iu5diTWTC69ZDbnRD0ogmfMRlIZYMF3kqH0YBHvGxSI,27009
+core/apps.py,sha256=fr4s_sNGe6gmSP4OPw-zDukIXpLkRnGzzW2h01Hg1f0,2577
+core/backends.py,sha256=f8gb5D3_f8sM6UJop0aS8TAkrkh14NaP0JrqTcT_L3Y,2686
+core/entity.py,sha256=Ok2dj-Hd5kJjzXaHIEIIfPY52nmucEmkH8mLO3N-10A,3107
+core/environment.py,sha256=QcOshpWNG0l_agW-b9efNvVFKqdatj6sUK8FT6p92gU,1238
+core/fields.py,sha256=uS5nDozL6IsTAbjg08VcOB8K85e0XROUYCBAOIfAcPE,2127
+core/lcd_screen.py,sha256=7iSg8OZMK8qHGM1FVOwbgsWCogEe5eR6mie-A5YQKY4,2649
+core/middleware.py,sha256=utMGESBrR-rHRV5_q1X2g2wnmpziaUcc9jGzoZwvqqQ,1258
+core/models.py,sha256=KtdlA3mefAbmU2cUsOZMAyvDxVSfExM69peTNyM02hk,43209
+core/notifications.py,sha256=w9rPCsZfZNSoBUH-1KVe9Yr8LvG9vtkgmzw3DKLcDoM,3787
+core/release.py,sha256=hoiw45zNh6wQ3N8rWx48EN5hh2fwcgkSRVGjBUKev_E,14959
+core/system.py,sha256=brMyjooSAPx1sYiRGEUkppD4tv7Ys2DNkahUSsaYa_A,3488
+core/tasks.py,sha256=Q4QweRlhahbXYEeL9ytlyQWwWQFP63q-ZY_fN0EXwtg,3145
+core/tests.py,sha256=hQLrDtnieZaThs5mWQXezcYFzLAqqSg4gTsHIlyq4-A,17872
+core/urls.py,sha256=pBkcWdiA0Aag7z4UOu7HT4Im4ghPPfBZKeogmoO0H5U,406
+core/user_data.py,sha256=pfi4fgHl0CosG9jkfe__bSNN-Knhnzp7UirnCT_tae8,12029
+core/views.py,sha256=D_1KF4IwDyqxicO1YSpOf4V4DMcVBfuRr8aDecdjpok,15342
+nodes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nodes/actions.py,sha256=2QOtRdhm__4f0Pgy3n2tg9HCbS47ZK9qBdTXJ9YZJfA,2339
+nodes/admin.py,sha256=YCjKqnb3GbYhke8CQI1VBzOliYjFEvJFkpobcxixfPY,12877
+nodes/apps.py,sha256=n1ZEsw5p6eYKaXEmachkT1saqQNLzeLExKyiYsoMazY,2297
+nodes/lcd.py,sha256=axttp6AhKO2QMMXAf6nPe3Ox7nrBP-8yZD_oDUfMAvI,5602
+nodes/models.py,sha256=wO8ppIVJLU26Kmab6FfPb9y3ROgVCuBs7Xd1hdSOkdQ,20887
+nodes/tasks.py,sha256=1YeUqwSvqqTisusH-25nMQJCMQY2faEyDVrcBYqQghU,1588
+nodes/tests.py,sha256=XyAM__wJpFyEK00sLGfYxeXWfOuxjOy-ofz8L7x2fw0,43133
+nodes/urls.py,sha256=20yZDZf4DNgIZ9hQWsUzjp8k5Fryg9ukk761_KGQt9k,548
+nodes/utils.py,sha256=aVEHtoisHyhWe_Fy2KPiP24Fs0wELtQMyfs4JGYnkuY,2320
+nodes/views.py,sha256=5LF82eIhhiOl4FdzhOKZbD-TUT5QSr_RvI6_Xz92_w4,8465
+ocpp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ocpp/admin.py,sha256=9A_uLUg7l9DiqJq1foy47oFLb7zPuBOJeS73p7l0M0k,11851
+ocpp/apps.py,sha256=QXwvJt1TnJKzxhZOSbyPjDIByLNhkBxu3_TQtZVoRB4,751
+ocpp/consumers.py,sha256=ykAkAicHRmn_qfUTp6psNUFkDrOnzuJfnHca9vgJLQI,11768
+ocpp/evcs.py,sha256=ZQKLqN8yJ4IOdedVt1z_gz_2eXBPdHHPvgxU2NkWgpw,33333
+ocpp/models.py,sha256=JN6CfoHdB84JM3VYN3-tEvd1xx7HrVCcZ8OsJgGUzYg,10364
+ocpp/routing.py,sha256=g9vPnLw-D1N8L_mW0_oCe-nTDibjC0Et-SFxe8NFAOI,308
+ocpp/simulator.py,sha256=kk2QWqekOrnNiSTwTO2kshAxGvxQrek36wy4uJgjhm0,13224
+ocpp/store.py,sha256=qzVWNXZY3sUAC3DtOnAv4BOj185DAGUxguVN9G4qkbw,5850
+ocpp/tasks.py,sha256=F15s9Hkx2Y54ytqXq3tyn0YmxgVepXsIctjuck2LWVI,841
+ocpp/test_export_import.py,sha256=w3GRh0zTWZ5byev7H1g9mZ3xbgnlHxQx2InHcp69x4w,4667
+ocpp/test_rfid.py,sha256=UrlB-amytnpvD1I4c0fRUKaPozRoEynYrZkKPCLfZDU,12318
+ocpp/tests.py,sha256=zq5C1-TGJXgsEoLJLc1Oq6ttn9o4V7xZ1jEzrWm1cJY,47752
+ocpp/transactions_io.py,sha256=ulRkBZTjubN01Geur9t4zjANQu-yCeS8N3prR03rQE8,4062
+ocpp/urls.py,sha256=MMrYiCW9y8cf2CZqpcEiF-jsjWdqLAl4a1cFnG36AEg,877
+ocpp/views.py,sha256=lX5vyCKxAOe-pBA5FpjbDiOt0zkx18GcH8NH0ncrDac,13201
+pages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pages/admin.py,sha256=hgaIeN0FyW4sWq4Ulhbr65wy5RfLheMkcmkint_urXA,7562
+pages/apps.py,sha256=P1zJH4LV3ATTu7z4r_BA-fiOtui_UW6-GP--LNMUYhs,299
+pages/checks.py,sha256=E2_ZYPD-2vw27ImA-Q29OvxbdQUvKx26ACZwiPflTaI,1569
+pages/context_processors.py,sha256=mQj43pb4Y1u8cfBrl3m0bP-_iWHDKXxfuRE4Rbn6l-g,2432
+pages/models.py,sha256=vG2knV91jRJ5PpIB-UKbsyuzB-e0KXYi9lwCFbIVUSA,7536
+pages/tests.py,sha256=AF6UbMg52RY8fq3PsbCydYCh0aUGPPdj14K_rTm8U7w,26034
+pages/urls.py,sha256=glhQExK2vVLzzvaRypWfmMdnggBrpjlxCaN1BUbC_MY,457
+pages/utils.py,sha256=bCcjku0mQhzgvTR46QwQgyc8YnSS7VumC6Qv968aCic,313
+pages/views.py,sha256=4msg1kPmcZFghpPa7lkwWpHKdBM01Aka5m7by31rXMc,7046
+arthexis-0.1.3.dist-info/METADATA,sha256=AUAQY7eIo7Cg_Absv4obDG2xpg-kIEh7o3tWNgwfI-k,4507
+arthexis-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+arthexis-0.1.3.dist-info/top_level.txt,sha256=J2a2q8_BWrCZ8H2WFUNMBfO2jz8j2gax6zZh-_1QDac,29
+arthexis-0.1.3.dist-info/RECORD,,

arthexis-0.1.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

arthexis-0.1.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rafael Guillen
+
+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.

arthexis-0.1.3.dist-info/top_level.txt

@@ -0,0 +1,5 @@
+config
+core
+nodes
+ocpp
+pages

config/__init__.py

@@ -0,0 +1,6 @@
+"""Config package initialization."""
+
+from .celery import app as celery_app
+
+__all__ = ("celery_app",)
+

config/active_app.py

@@ -0,0 +1,15 @@
+import threading
+import socket
+
+_active = threading.local()
+_active.name = socket.gethostname()
+
+
+def get_active_app():
+    """Return the currently active app name."""
+    return getattr(_active, "name", socket.gethostname())
+
+
+def set_active_app(name: str) -> None:
+    """Set the active app name for the current thread."""
+    _active.name = name or socket.gethostname()

config/asgi.py

@@ -0,0 +1,29 @@
+"""
+ASGI config for config project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/howto/deployment/asgi/
+"""
+
+import os
+from config.loadenv import loadenv
+from channels.auth import AuthMiddlewareStack
+from channels.routing import ProtocolTypeRouter, URLRouter
+from django.core.asgi import get_asgi_application
+import ocpp.routing
+
+loadenv()
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+
+django_asgi_app = get_asgi_application()
+
+websocket_patterns = ocpp.routing.websocket_urlpatterns
+
+application = ProtocolTypeRouter(
+    {
+        "http": django_asgi_app,
+        "websocket": AuthMiddlewareStack(URLRouter(websocket_patterns)),
+    }
+)

config/auth_app.py

@@ -0,0 +1,8 @@
+from django.contrib.auth.apps import AuthConfig as DjangoAuthConfig
+
+
+class AuthConfig(DjangoAuthConfig):
+    """Use a shorter label for the auth section in the admin."""
+
+    verbose_name = "AUTH"
+

config/celery.py

@@ -0,0 +1,19 @@
+"""Celery application configuration."""
+
+import os
+
+from celery import Celery
+
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "config.settings")
+
+app = Celery("config")
+app.config_from_object("django.conf:settings", namespace="CELERY")
+app.autodiscover_tasks()
+
+
+@app.task(bind=True)
+def debug_task(self):  # pragma: no cover - debug helper
+    """A simple debug task."""
+    print(f"Request: {self.request!r}")
+

config/context_processors.py

@@ -0,0 +1,68 @@
+import socket
+
+from django.contrib.sites.models import Site
+from django.http import HttpRequest
+from django.conf import settings
+
+
+def site_and_node(request: HttpRequest):
+    """Provide current Site and Node based on request host.
+
+    Returns a dict with keys ``badge_site`` and ``badge_node``.
+    ``badge_site`` is a ``Site`` instance or ``None`` if no match.
+    ``badge_node`` is a ``Node`` instance or ``None`` if no match.
+    ``badge_site_color`` and ``badge_node_color`` provide the configured colors.
+    """
+    host = request.get_host().split(':')[0]
+    site = Site.objects.filter(domain__iexact=host).first()
+
+    node = None
+    try:
+        from nodes.models import Node
+
+        node = Node.get_local()
+        if not node:
+            hostname = socket.gethostname()
+            try:
+                addresses = socket.gethostbyname_ex(hostname)[2]
+            except socket.gaierror:
+                addresses = []
+
+            node = Node.objects.filter(hostname__iexact=hostname).first()
+            if not node:
+                for addr in addresses:
+                    node = Node.objects.filter(address=addr).first()
+                    if node:
+                        break
+            if not node:
+                node = (
+                    Node.objects.filter(hostname__iexact=host).first()
+                    or Node.objects.filter(address=host).first()
+                )
+    except Exception:
+        node = None
+
+    site_color = "#28a745"
+    if site:
+        try:
+            site_color = site.badge.badge_color
+        except Exception:
+            pass
+
+    node_color = "#28a745"
+    if node:
+        node_color = node.badge_color
+
+    site_name = site.name if site else ""
+    node_role_name = node.role.name if node and node.role else ""
+    return {
+        "badge_site": site,
+        "badge_node": node,
+        # Public views fall back to the node role when the site name is blank.
+        "badge_site_name": site_name or node_role_name,
+        # Admin site badge uses the site display name if set, otherwise the domain.
+        "badge_admin_site_name": site_name or (site.domain if site else ""),
+        "badge_site_color": site_color,
+        "badge_node_color": node_color,
+        "TIME_ZONE": settings.TIME_ZONE,
+    }

config/loadenv.py

@@ -0,0 +1,11 @@
+from pathlib import Path
+from dotenv import load_dotenv
+
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+def loadenv() -> None:
+    """Load all .env files from the repository root."""
+    for env_file in sorted(BASE_DIR.glob("*.env")):
+        load_dotenv(env_file, override=False)

config/logging.py

@@ -0,0 +1,43 @@
+import sys
+import os
+import glob
+import logging
+from logging.handlers import TimedRotatingFileHandler
+from pathlib import Path
+from django.conf import settings
+
+from .active_app import get_active_app
+
+
+class ActiveAppFileHandler(TimedRotatingFileHandler):
+    """File handler that writes to a file named after the active app."""
+
+    def _current_file(self) -> Path:
+        if "test" in sys.argv:
+            return Path(settings.LOG_DIR) / "tests.log"
+        return Path(settings.LOG_DIR) / f"{get_active_app()}.log"
+
+    def emit(self, record: logging.LogRecord) -> None:
+        current = str(self._current_file())
+        if self.baseFilename != current:
+            self.baseFilename = current
+            if self.stream:
+                self.stream.close()
+            self.stream = self._open()
+        super().emit(record)
+
+    def rotation_filename(self, default_name: str) -> str:
+        """Place rotated logs inside the old log directory."""
+        default_path = Path(default_name)
+        return str(Path(settings.OLD_LOG_DIR) / default_path.name)
+
+    def getFilesToDelete(self):
+        """Return files to delete in the old log directory respecting backupCount."""
+        if self.backupCount <= 0:
+            return []
+        _, base_name = os.path.split(self.baseFilename)
+        files = glob.glob(os.path.join(settings.OLD_LOG_DIR, base_name + ".*"))
+        files.sort()
+        if len(files) <= self.backupCount:
+            return []
+        return files[: len(files) - self.backupCount]

config/middleware.py

@@ -0,0 +1,25 @@
+from utils.sites import get_site
+import socket
+from nodes.models import Node
+
+from .active_app import set_active_app
+
+
+class ActiveAppMiddleware:
+    """Store the current app based on the request's site."""
+
+    def __init__(self, get_response):
+        self.get_response = get_response
+
+    def __call__(self, request):
+        site = get_site(request)
+        node = Node.get_local()
+        role_name = node.role.name if node and node.role else "Terminal"
+        active = site.name or role_name
+        set_active_app(active)
+        request.active_app = active
+        try:
+            response = self.get_response(request)
+        finally:
+            set_active_app(socket.gethostname())
+        return response

config/offline.py

@@ -0,0 +1,47 @@
+import os
+import functools
+import asyncio
+
+class OfflineError(RuntimeError):
+    """Raised when a network operation is attempted in offline mode."""
+
+
+def _is_offline() -> bool:
+    flag = os.environ.get("ARTHEXIS_OFFLINE", "").lower()
+    return flag not in ("", "0", "false", "no")
+
+
+def requires_network(func):
+    """Decorator that blocks execution when offline mode is enabled.
+
+    When the environment variable ``ARTHEXIS_OFFLINE`` is set to a truthy value,
+    any function decorated with ``@requires_network`` will raise
+    :class:`OfflineError` before executing. Works with both synchronous and
+    asynchronous callables.
+    """
+
+    if asyncio.iscoroutinefunction(func):
+        @functools.wraps(func)
+        async def async_wrapper(*args, **kwargs):
+            if _is_offline():
+                raise OfflineError(f"{func.__name__} requires network access")
+            return await func(*args, **kwargs)
+
+        return async_wrapper
+
+    @functools.wraps(func)
+    def sync_wrapper(*args, **kwargs):
+        if _is_offline():
+            raise OfflineError(f"{func.__name__} requires network access")
+        return func(*args, **kwargs)
+
+    return sync_wrapper
+
+
+def network_available() -> bool:
+    """Return ``True`` if network operations are permitted."""
+
+    return not _is_offline()
+
+
+__all__ = ["OfflineError", "requires_network", "network_available"]