dimples 1.6.0__tar.gz → 1.6.2__tar.gz

{dimples-1.6.0 → dimples-1.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dimples
-Version: 1.6.0
+Version: 1.6.2
 Summary: DIMP Library for Edges and Stations
 Home-page: https://github.com/dimchat/demo-py
 Author: Albert Moky
@@ -47,20 +47,20 @@ License-File: LICENSE
         # 'pycryptodome',  # 3.14.1
         # 'base58',  # 1.0.3
         # 'ecdsa',   # 0.16.1
-        'dimplugins>=2.3.3',
+        'dimplugins>=2.4.0',
 
-        'dimsdk>=2.3.3',
-        # 'dimp>=2.3.3',
-        # 'dkd>=2.3.3',
-        # 'mkm>=2.3.3',
+        'dimsdk>=2.4.0',
+        # 'dimp>=2.4.0',
+        # 'dkd>=2.4.0',
+        # 'mkm>=2.4.0',
 
-        'startrek>=2.2.2',
-        'tcp>=2.2.2',
-        'udp>=2.2.2',
+        'startrek>=2.3.0',
+        'tcp>=2.3.0',
+        'udp>=2.3.0',
 
         'aiou>=1.1.0',
     ]
 ```
 
-Copyright © 2018-2025 Albert Moky
+Copyright © 2018-2026 Albert Moky
 [![Followers](https://img.shields.io/github/followers/moky)](https://github.com/moky?tab=followers)

{dimples-1.6.0 → dimples-1.6.2}/README.md

@@ -33,20 +33,20 @@
         # 'pycryptodome',  # 3.14.1
         # 'base58',  # 1.0.3
         # 'ecdsa',   # 0.16.1
-        'dimplugins>=2.3.3',
+        'dimplugins>=2.4.0',
 
-        'dimsdk>=2.3.3',
-        # 'dimp>=2.3.3',
-        # 'dkd>=2.3.3',
-        # 'mkm>=2.3.3',
+        'dimsdk>=2.4.0',
+        # 'dimp>=2.4.0',
+        # 'dkd>=2.4.0',
+        # 'mkm>=2.4.0',
 
-        'startrek>=2.2.2',
-        'tcp>=2.2.2',
-        'udp>=2.2.2',
+        'startrek>=2.3.0',
+        'tcp>=2.3.0',
+        'udp>=2.3.0',
 
         'aiou>=1.1.0',
     ]
 ```
 
-Copyright © 2018-2025 Albert Moky
+Copyright © 2018-2026 Albert Moky
 [![Followers](https://img.shields.io/github/followers/moky)](https://github.com/moky?tab=followers)

{dimples-1.6.0 → dimples-1.6.2}/dimples/__init__.py

@@ -29,9 +29,11 @@
 # ==============================================================================
 
 from dimsdk import *
-from dimsdk.cpu import *
 from dimplugins import *
 
+from dimplugins.ext_core import crypto_extensions, format_extensions
+from dimplugins.ext_core import account_extensions, message_extensions, command_extensions
+
 from .utils import md5, sha1
 
 from .common import *
@@ -49,14 +51,6 @@ __author__ = 'Albert Moky'
 
 __all__ = [
 
-    'Emitter',
-
-    ####################################
-    #
-    #   SDK
-    #
-    ####################################
-
     'Singleton',
 
     'URI', 'DateTime',
@@ -96,6 +90,7 @@ __all__ = [
     #
     #   TED
     #
+
     'EncodeAlgorithms',
 
     'BaseString', 'BaseData',
@@ -106,9 +101,11 @@ __all__ = [
     #
     #   PNF
     #
+
     'TransportableFile', 'TransportableFileFactory',
-    'TransportableFileHelper',
+    # 'TransportableFileHelper', 'TransportableFileExtension',
     'TransportableFileWrapper', 'TransportableFileWrapperFactory',
+    # 'TransportableFileWrapperExtension',
 
     'PortableNetworkFile',
     'PortableNetworkFileWrapper',
@@ -133,11 +130,14 @@ __all__ = [
     'SymmetricKeyFactory', 'PrivateKeyFactory', 'PublicKeyFactory',
 
     'SymmetricKeyHelper', 'PublicKeyHelper', 'PrivateKeyHelper',
+
+    'SymmetricKeyExtension', 'PublicKeyExtension', 'PrivateKeyExtension',
     'CryptoExtensions', 'shared_crypto_extensions',
 
     #
     #   Algorithms
     #
+
     'AsymmetricAlgorithms', 'SymmetricAlgorithms',
 
     #
@@ -157,18 +157,10 @@ __all__ = [
 
     'AddressHelper', 'IDHelper',
     'MetaHelper', 'DocumentHelper',
-    'AccountExtensions', 'shared_account_extensions',
-
-    #
-    #   Account Extends
-    #
-
-    'GeneralCryptoHelper',
-    'GeneralAccountHelper',
 
-    'MetaType',
-    'DocumentType',
-    'Visa', 'Bulletin',
+    'AddressExtension', 'IDExtension',
+    'MetaExtension', 'DocumentExtension',
+    'AccountExtensions', 'shared_account_extensions',
 
     #
     #   Dao-Ke-Dao
@@ -183,18 +175,25 @@ __all__ = [
 
     'ContentHelper', 'EnvelopeHelper',
     'InstantMessageHelper', 'SecureMessageHelper', 'ReliableMessageHelper',
+
+    'ContentExtension',
+    'InstantMessageExtension', 'SecureMessageExtension', 'ReliableMessageExtension',
     'MessageExtensions', 'shared_message_extensions',
 
     #
-    #   Message Extends
+    #   Core Protocols
     #
 
-    'GeneralMessageHelper',
+    'MetaType',
+    'DocumentType',
+    'Visa', 'Bulletin',
 
     'ContentType',
 
     'Command', 'CommandFactory',
-    'CommandHelper', 'GeneralCommandHelper',
+
+    # 'CommandHelper', 'GeneralCommandHelper',
+    # 'CommandExtension', 'CmdExtension',
 
     #
     #  Contents
@@ -205,7 +204,7 @@ __all__ = [
     'FileContent', 'ImageContent', 'AudioContent', 'VideoContent',
     'ForwardContent', 'CombineContent', 'ArrayContent',
     'QuoteContent',
-    'QuoteHelper', 'QuotePurifier',
+    # 'QuoteHelper', 'QuotePurifier', 'QuoteExtension',
 
     #
     #  Commands
@@ -218,22 +217,26 @@ __all__ = [
     'InviteCommand', 'ExpelCommand', 'JoinCommand', 'QuitCommand', 'ResetCommand',
 
     #
-    #   Implementations
+    #   Account Implementations
     #
 
     'BaseMeta',
     'BaseDocument', 'BaseVisa', 'BaseBulletin',
 
     #
-    #   Contents
+    #   Content Implementations
+    #
 
     'BaseContent', 'BaseCommand',
+    # 'CommandHelper', 'GeneralCommandHelper',
+    # 'CommandExtension', 'CmdExtension',
 
     'BaseTextContent', 'WebPageContent', 'NameCardContent',
     'BaseMoneyContent', 'TransferMoneyContent',
     'BaseFileContent', 'ImageFileContent', 'AudioFileContent', 'VideoFileContent',
     'SecretContent', 'CombineForwardContent', 'ListContent',
     'BaseQuoteContent',
+    # 'QuoteHelper', 'QuotePurifier', 'QuoteExtension',
 
     'BaseMetaCommand', 'BaseDocumentCommand',
     'BaseReceiptCommand',
@@ -241,19 +244,41 @@ __all__ = [
     'InviteGroupCommand', 'ExpelGroupCommand', 'JoinGroupCommand', 'QuitGroupCommand', 'ResetGroupCommand',
 
     #
-    #   Messages
+    #   Message Implementations
     #
 
     'MessageEnvelope',
     'BaseMessage',
     'PlainMessage', 'EncryptedMessage', 'NetworkMessage',
 
+    'GeneralCryptoHelper', 'GeneralCryptoExtension',
+    'GeneralAccountHelper', 'GeneralAccountExtension',
+
+    'GeneralMessageHelper', 'GeneralMessageExtension',
+
+    'TransportableFileHelper',
+    'TransportableFileExtension',
+    'TransportableFileWrapperExtension',
+
+    'CommandHelper', 'GeneralCommandHelper',
+    'CommandExtension', 'CmdExtension',
+
+    'QuoteHelper', 'QuotePurifier',
+    'QuoteExtension',
+
+
+    ################################################################
+    #
+    #   Software Development Kits
+    #
     ################################################################
 
     'EncryptedBundle', 'UserEncryptedBundle',
     'EncryptedBundleHelper', 'DefaultBundleHelper',
+    'EncryptedBundleExtension',
 
     'VisaAgent', 'DefaultVisaAgent',
+    'VisaAgentExtension',
 
     #
     #   Entities (MingKeMing)
@@ -282,7 +307,7 @@ __all__ = [
     'ReliableMessagePacker',
 
     'MessagePackerFactory',
-    'PackerExtensions',
+    'MessagePackerExtension',
 
     #
     #   Content Processors (DaoKeDao)
@@ -322,61 +347,63 @@ __all__ = [
     'MessageProcessor',
     'MessagePacker',
 
-    ####################################
     #
-    #   SDK CPU
+    #   CPU - Content Processing Units
     #
-    ####################################
 
     'ContentProcessor',
     'ContentProcessorCreator',
     'ContentProcessorFactory',
     'GeneralContentProcessorFactory',
 
-    #
-    #   CPU
-    #
-
-    'BaseContentProcessor',
-    'BaseCommandProcessor',
-
-    'ArrayContentProcessor',
-    'ForwardContentProcessor',
-
-    'MetaCommandProcessor',
-    'DocumentCommandProcessor',
-
+    'BaseContentProcessor', 'BaseCommandProcessor',
+    'ArrayContentProcessor', 'ForwardContentProcessor',
+    'MetaCommandProcessor', 'DocumentCommandProcessor',
     'BaseContentProcessorCreator',
 
-    ####################################
+
+    ################################################################
     #
     #   Plugins
     #
-    ####################################
+    ################################################################
 
     'TransportableDataHelper',
     'FormatExtensions', 'shared_format_extensions',
 
     'SymmetricKeyHelper', 'PublicKeyHelper', 'PrivateKeyHelper',
+
+    'SymmetricKeyExtension', 'PublicKeyExtension', 'PrivateKeyExtension',
     'CryptoExtensions', 'shared_crypto_extensions',
 
     'AddressHelper', 'IDHelper',
     'MetaHelper', 'DocumentHelper',
+
+    'AddressExtension', 'IDExtension',
+    'MetaExtension', 'DocumentExtension',
     'AccountExtensions', 'shared_account_extensions',
 
-    'GeneralCryptoHelper',
-    'GeneralAccountHelper',
+    'GeneralCryptoHelper', 'GeneralCryptoExtension',
+    'GeneralAccountHelper', 'GeneralAccountExtension',
 
     'ContentHelper', 'EnvelopeHelper',
     'InstantMessageHelper', 'SecureMessageHelper', 'ReliableMessageHelper',
+
+    'ContentExtension',
+    'InstantMessageExtension', 'SecureMessageExtension', 'ReliableMessageExtension',
     'MessageExtensions', 'shared_message_extensions',
 
-    'GeneralMessageHelper',
+    'GeneralMessageHelper', 'GeneralMessageExtension',
 
     'TransportableFileHelper',
+    'TransportableFileExtension',
+    'TransportableFileWrapperExtension',
 
     'CommandHelper', 'GeneralCommandHelper',
+    'CommandExtension', 'CmdExtension',
+
     'QuoteHelper', 'QuotePurifier',
+    'QuoteExtension',
 
     #
     #   Memory Cache
@@ -385,6 +412,8 @@ __all__ = [
     'MemoryCache',
     'ThanosCache',
 
+    'MemoryCacheExtension',
+
     #
     #   Crypto
     #
@@ -421,7 +450,7 @@ __all__ = [
     # 'TransportableMixIn',
 
     #
-    #   MingKeMing
+    #   Ming-Ke-Ming
     #
 
     'BTCAddress', 'ETHAddress',
@@ -435,7 +464,7 @@ __all__ = [
     'GeneralDocumentFactory',
 
     #
-    #   DaoKeDao
+    #   Dao-Ke-Dao
     #
 
     'GeneralCommandFactory',
@@ -456,15 +485,19 @@ __all__ = [
     #   Loaders
     #
 
+    # 'CoreMixIn', 'EntityMixIn', 'MessageFactoryMixIn',
+    # 'CryptoMixIn',
+
     'ContentParser', 'CommandParser',
     'ExtensionLoader',
     'PluginLoader',
 
-    ####################################
+
+    ################################################################
     #
     #   Common
     #
-    ####################################
+    ################################################################
 
     'MetaVersion',
     'Password',
@@ -689,4 +722,17 @@ __all__ = [
 
     'SharedGroupManager',
 
+    ####################################
+    #
+    #   Others
+    #
+    ####################################
+
+    'crypto_extensions', 'format_extensions',
+    'account_extensions', 'message_extensions', 'command_extensions',
+
+    'md5', 'sha1',
+
+    'Emitter',
+
 ]

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/checker.py

@@ -36,6 +36,7 @@ from dimsdk import Content
 from dimsdk import MetaCommand, DocumentCommand
 
 from ..utils import Logging
+from ..common import DocumentUtils
 from ..common import Station
 from ..common import QueryCommand
 from ..common import EntityChecker
@@ -198,8 +199,7 @@ class ClientChecker(EntityChecker, Logging):
 
     # Override
     async def send_visa(self, visa: Visa, receiver: ID, updated: bool = False) -> bool:
-        did = visa.get('did')
-        me = ID.parse(identifier=did)
+        me = DocumentUtils.get_document_id(document=visa)
         if me == receiver:
             self.warning(msg='skip cycled message: %s, %s' % (receiver, visa))
             return False

dimples-1.6.2/dimples/client/compat/__init__.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+# ==============================================================================
+# MIT License
+#
+# Copyright (c) 2026 Albert Moky
+#
+# 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.
+# ==============================================================================
+
+from .loader import ClientLibraryLoader
+from .loader import ClientExtensionLoader
+
+
+__all__ = [
+
+    'ClientLibraryLoader',
+    'ClientExtensionLoader',
+
+]

dimples-1.6.2/dimples/client/compat/loader.py

@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+# ==============================================================================
+# MIT License
+#
+# Copyright (c) 2026 Albert Moky
+#
+# 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.
+# ==============================================================================
+
+from dimplugins import ExtensionLoader, PluginLoader
+
+from ...common.compat import CommonExtensionLoader, CommonPluginLoader
+from ...common import GroupHistory
+
+from ..cpu.app.filter import get_app_filter
+from ..cpu import GroupHistoryHandler
+
+
+class ClientLibraryLoader:
+
+    def __init__(self, extensions: ExtensionLoader = None, plugins: PluginLoader = None):
+        super().__init__()
+        self.__extensions = ClientExtensionLoader() if extensions is None else extensions
+        self.__plugins = CommonPluginLoader() if plugins is None else plugins
+        self.__loaded = False
+
+    def run(self):
+        if self.__loaded:
+            # no need to load it again
+            return
+        else:
+            # mark it to loaded
+            self.__loaded = True
+        # try to load all plugins
+        self.load()
+
+    def load(self):
+        self.__extensions.load()
+        self.__plugins.load()
+
+
+class ClientExtensionLoader(CommonExtensionLoader):
+
+    # Override
+    def load(self):
+        super().load()
+        self._register_customized_handlers()
+
+    # noinspection PyMethodMayBeStatic
+    def _register_customized_handlers(self):
+        app_filter = get_app_filter()
+        # 'chat.dim.group:history'
+        app_filter.set_content_handler(app=GroupHistory.APP,
+                                       mod=GroupHistory.MOD,
+                                       handler=GroupHistoryHandler()
+                                       )

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/cpu/__init__.py

@@ -47,7 +47,7 @@ from .grp_resign import ResignCommandProcessor
 
 from .app import CustomizedContentHandler, BaseCustomizedContentHandler
 from .app import CustomizedContentFilter, AppCustomizedFilter
-from .app import CustomizedFilterExtensions
+from .app import CustomizedFilterExtension
 from .app import GroupHistoryHandler
 
 from .customized import CustomizedContentProcessor
@@ -81,7 +81,7 @@ __all__ = [
 
     'CustomizedContentHandler', 'BaseCustomizedContentHandler',
     'CustomizedContentFilter', 'AppCustomizedFilter',
-    'CustomizedFilterExtensions',
+    'CustomizedFilterExtension',
     'GroupHistoryHandler',
 
     'CustomizedContentProcessor',

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/cpu/app/__init__.py

@@ -31,7 +31,7 @@
 from .handler import CustomizedContentHandler, BaseCustomizedContentHandler
 
 from .filter import CustomizedContentFilter, AppCustomizedFilter
-from .filter import CustomizedFilterExtensions
+from .filter import CustomizedFilterExtension
 
 from .group import GroupHistoryHandler
 
@@ -41,7 +41,7 @@ __all__ = [
     'CustomizedContentHandler', 'BaseCustomizedContentHandler',
 
     'CustomizedContentFilter', 'AppCustomizedFilter',
-    'CustomizedFilterExtensions',
+    'CustomizedFilterExtension',
 
     'GroupHistoryHandler',
 

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/cpu/app/filter.py

@@ -81,7 +81,7 @@ class AppCustomizedFilter(CustomizedContentFilter):
 # -----------------------------------------------------------------------------
 
 
-class CustomizedFilterExtensions:
+class CustomizedFilterExtension:
 
     @property
     def customized_filter(self) -> CustomizedContentFilter:
@@ -95,5 +95,14 @@ class CustomizedFilterExtensions:
 shared_message_extensions.customized_filter = AppCustomizedFilter()
 
 
-# def message_extensions() -> Union[MessageExtensions, CustomizedFilterExtensions]:
-#     return shared_message_extensions
+def customized_extensions() -> CustomizedFilterExtension:
+    return shared_message_extensions
+
+
+def get_app_filter() -> AppCustomizedFilter:
+    ext = customized_extensions()
+    customized_filter = ext.customized_filter
+    if not isinstance(customized_filter, AppCustomizedFilter):
+        customized_filter = AppCustomizedFilter()
+        ext.customized_filter = customized_filter
+    return customized_filter

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/cpu/app/group.py

@@ -76,7 +76,7 @@ class GroupHistoryHandler(BaseCustomizedContentHandler):
 
     async def __transform_query_command(self, content: CustomizedContent, msg: ReliableMessage,
                                         messenger: Messenger) -> List[Content]:
-        info = content.copy_dictionary()
+        info = content.copy_dict()
         info['type'] = ContentType.COMMAND
         info['command'] = QueryCommand.QUERY
         query = Content.parse(content=info)

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/cpu/customized.py

@@ -28,16 +28,15 @@
 # SOFTWARE.
 # ==============================================================================
 
-from typing import Union, List
+from typing import List
 
 from dimsdk import ReliableMessage
 from dimsdk import Content
-from dimsdk import MessageExtensions, shared_message_extensions
 from dimsdk.cpu import BaseContentProcessor
 
 from ...common import CustomizedContent
 
-from .app import CustomizedFilterExtensions
+from .app.filter import get_app_filter
 
 
 class CustomizedContentProcessor(BaseContentProcessor):
@@ -53,12 +52,7 @@ class CustomizedContentProcessor(BaseContentProcessor):
     # Override
     async def process_content(self, content: Content, r_msg: ReliableMessage) -> List[Content]:
         assert isinstance(content, CustomizedContent), 'customized content error: %s' % content
-        ext = message_extensions()
-        customized_filter = ext.customized_filter
+        customized_filter = get_app_filter()
         # get handler for 'app' & 'mod'
         handler = customized_filter.filter_content(content=content, msg=r_msg)
         return await handler.handle_action(content=content, msg=r_msg, messenger=self.messenger)
-
-
-def message_extensions() -> Union[MessageExtensions, CustomizedFilterExtensions]:
-    return shared_message_extensions

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/facebook.py

@@ -37,6 +37,7 @@ from dimsdk import ID, Document, Bulletin
 from dimsdk import Group
 
 from ..utils import Runner
+from ..common import DocumentUtils
 from ..common import BroadcastUtils
 from ..common import CommonFacebook
 from ..common import CommonArchivist
@@ -57,8 +58,7 @@ class ClientArchivist(CommonArchivist):
             # check administrators
             array = document.get_property(name='administrators')
             if array is not None:
-                did = document.get('did')
-                group = ID.parse(identifier=did)
+                group = DocumentUtils.get_document_id(document=document)
                 assert group.is_group, 'group ID error: %s' % group
                 admins = ID.convert(array=array)
                 db = self.database

{dimples-1.6.0 → dimples-1.6.2}/dimples/client/messenger.py

@@ -199,7 +199,7 @@ class ClientMessenger(CommonMessenger):
             return None
         else:
             # clone for modifying
-            visa = Document.parse(document=visa.copy_dictionary())
+            visa = Document.parse(document=visa.copy_dict())
             if not isinstance(visa, Visa):
                 self.error(msg='visa error: %s' % visa)
                 return None