dimp 2.3.3__tar.gz → 2.4.0__tar.gz

{dimp-2.3.3 → dimp-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dimp
-Version: 2.3.3
+Version: 2.4.0
 Summary: Decentralized Instant Messaging Protocol
 Home-page: https://github.com/dimchat/core-py
 Author: Albert Moky
@@ -18,7 +18,7 @@ License-File: LICENSE
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/dimchat/core-py/pulls)
 [![Platform](https://img.shields.io/badge/Platform-Python%203-brightgreen.svg)](https://github.com/dimchat/core-py/wiki)
 [![Issues](https://img.shields.io/github/issues/dimchat/core-py)](https://github.com/dimchat/core-py/issues)
-[![Repo Size](https://img.shields.io/github/repo-size/dimchat/core-py)](https://github.com/dimchat/core-py/archive/refs/heads/main.zip)
+[![Repo Size](https://img.shields.io/github/repo-size/dimchat/core-py)](https://github.com/dimchat/core-py/archive/refs/heads/master.zip)
 [![Tags](https://img.shields.io/github/tag/dimchat/core-py)](https://github.com/dimchat/core-py/tags)
 [![Version](https://img.shields.io/pypi/v/dimp)](https://pypi.org/project/dimp)
 
@@ -36,7 +36,7 @@ License-File: LICENSE
 
 ## Examples
 
-### extends Command
+### Extends Command
 
 * _Handshake Command Protocol_
   0. (C-S) handshake start
@@ -49,7 +49,7 @@ from abc import ABC, abstractmethod
 from enum import IntEnum
 from typing import Optional, Dict
 
-from dimp import Command, BaseCommand
+from dimp import *
 
 
 class HandshakeState(IntEnum):
@@ -78,12 +78,12 @@ class HandshakeCommand(Command, ABC):
         ~~~~~~~~~~~~~~~~~
 
         data format: {
-            type : 0x88,
-            sn   : 123,
+            "type" : i2s(0x88),
+            "sn"   : 12345,
 
-            command : "handshake",    // command name
-            title   : "Hello world!", // "DIM?", "DIM!"
-            session : "{SESSION_ID}", // session key
+            "command" : "handshake",    // command name
+            "title"   : "Hello world!", // "DIM?", "DIM!"
+            "session" : "{SESSION_ID}", // session key
         }
     """
     HANDSHAKE = 'handshake'
@@ -172,30 +172,25 @@ class BaseHandshakeCommand(BaseCommand, HandshakeCommand):
         return handshake_state(title=self.title, session=self.session)
 ```
 
-### extends Content
+### Extends Content
 
 ```python
 from abc import ABC, abstractmethod
-from typing import Any, Dict
 
-from dimp import ContentType
-from dimp import Content
-from dimp import BaseContent
+from dimp import *
 
 
 class AppContent(Content, ABC):
     """
-        Application Customized message
-        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+        Content for Application 0nly
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
         data format: {
-            type : 0xA0,
-            sn   : 123,
+            "type" : i2s(0xA0),
+            "sn"   : 12345,
 
-            app   : "{APP_ID}",  // application (e.g.: "chat.dim.sechat")
-            mod   : "{MODULE}",  // module name (e.g.: "drift_bottle")
-            act   : "{ACTION}",  // action name (e.g.: "throw")
-            extra : info         // action parameters
+            "app"   : "{APP_ID}",  // application (e.g.: "chat.dim.sechat")
+            "extra" : info         // action parameters
         }
     """
 
@@ -205,6 +200,23 @@ class AppContent(Content, ABC):
         """ App ID """
         raise NotImplemented
 
+
+class CustomizedContent(Content, ABC):
+    """
+        Application Customized message
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+        data format: {
+            "type" : i2s(0xCC),
+            "sn"   : 12345,
+
+            "app"   : "{APP_ID}",  // application (e.g.: "chat.dim.sechat")
+            "mod"   : "{MODULE}",  // module name (e.g.: "drift_bottle")
+            "act"   : "{ACTION}",  // action name (e.g.: "throw")
+            "extra" : info         // action parameters
+        }
+    """
+
     @property
     @abstractmethod
     def module(self) -> str:
@@ -218,16 +230,22 @@ class AppContent(Content, ABC):
         raise NotImplemented
 
     #
-    #   Factory
+    #   Factory method
     #
     @classmethod
     def create(cls, app: str, mod: str, act: str):
-        return ApplicationContent(app=app, mod=mod, act=act)
+        return AppCustomizedContent(app=app, mod=mod, act=act)
+```
+
+```python
+from typing import Dict
+
+from dimp import *
 
 
-class ApplicationContent(BaseContent, AppContent):
+class AppCustomizedContent(BaseContent, AppContent, CustomizedContent):
 
-    def __init__(self, content: Dict[str, Any] = None,
+    def __init__(self, content: Dict = None,
                  msg_type: str = None,
                  app: str = None, mod: str = None, act: str = None):
         if content is None:
@@ -235,7 +253,7 @@ class ApplicationContent(BaseContent, AppContent):
             assert app is not None and mod is not None and act is not None, \
                 'customized content error: %s, %s, %s, %s' % (msg_type, app, mod, act)
             if msg_type is None:
-                msg_type = ContentType.APPLICATION
+                msg_type = ContentType.CUSTOMIZED
             super().__init__(None, msg_type)
             self['app'] = app
             self['mod'] = mod
@@ -259,11 +277,11 @@ class ApplicationContent(BaseContent, AppContent):
         return self.get_str(key='act', default='')
 ```
 
-### extends ID Address
+### Extends ID Address
 
 * Examples in [dim plugins](https://pypi.org/project/dimplugins)
 
 ----
 
-Copyright © 2018-2025 Albert Moky
+Copyright © 2018-2026 Albert Moky
 [![Followers](https://img.shields.io/github/followers/moky)](https://github.com/moky?tab=followers)

{dimp-2.3.3 → dimp-2.4.0}/README.md

@@ -4,7 +4,7 @@
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/dimchat/core-py/pulls)
 [![Platform](https://img.shields.io/badge/Platform-Python%203-brightgreen.svg)](https://github.com/dimchat/core-py/wiki)
 [![Issues](https://img.shields.io/github/issues/dimchat/core-py)](https://github.com/dimchat/core-py/issues)
-[![Repo Size](https://img.shields.io/github/repo-size/dimchat/core-py)](https://github.com/dimchat/core-py/archive/refs/heads/main.zip)
+[![Repo Size](https://img.shields.io/github/repo-size/dimchat/core-py)](https://github.com/dimchat/core-py/archive/refs/heads/master.zip)
 [![Tags](https://img.shields.io/github/tag/dimchat/core-py)](https://github.com/dimchat/core-py/tags)
 [![Version](https://img.shields.io/pypi/v/dimp)](https://pypi.org/project/dimp)
 
@@ -22,7 +22,7 @@
 
 ## Examples
 
-### extends Command
+### Extends Command
 
 * _Handshake Command Protocol_
   0. (C-S) handshake start
@@ -35,7 +35,7 @@ from abc import ABC, abstractmethod
 from enum import IntEnum
 from typing import Optional, Dict
 
-from dimp import Command, BaseCommand
+from dimp import *
 
 
 class HandshakeState(IntEnum):
@@ -64,12 +64,12 @@ class HandshakeCommand(Command, ABC):
         ~~~~~~~~~~~~~~~~~
 
         data format: {
-            type : 0x88,
-            sn   : 123,
+            "type" : i2s(0x88),
+            "sn"   : 12345,
 
-            command : "handshake",    // command name
-            title   : "Hello world!", // "DIM?", "DIM!"
-            session : "{SESSION_ID}", // session key
+            "command" : "handshake",    // command name
+            "title"   : "Hello world!", // "DIM?", "DIM!"
+            "session" : "{SESSION_ID}", // session key
         }
     """
     HANDSHAKE = 'handshake'
@@ -158,30 +158,25 @@ class BaseHandshakeCommand(BaseCommand, HandshakeCommand):
         return handshake_state(title=self.title, session=self.session)
 ```
 
-### extends Content
+### Extends Content
 
 ```python
 from abc import ABC, abstractmethod
-from typing import Any, Dict
 
-from dimp import ContentType
-from dimp import Content
-from dimp import BaseContent
+from dimp import *
 
 
 class AppContent(Content, ABC):
     """
-        Application Customized message
-        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+        Content for Application 0nly
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
         data format: {
-            type : 0xA0,
-            sn   : 123,
+            "type" : i2s(0xA0),
+            "sn"   : 12345,
 
-            app   : "{APP_ID}",  // application (e.g.: "chat.dim.sechat")
-            mod   : "{MODULE}",  // module name (e.g.: "drift_bottle")
-            act   : "{ACTION}",  // action name (e.g.: "throw")
-            extra : info         // action parameters
+            "app"   : "{APP_ID}",  // application (e.g.: "chat.dim.sechat")
+            "extra" : info         // action parameters
         }
     """
 
@@ -191,6 +186,23 @@ class AppContent(Content, ABC):
         """ App ID """
         raise NotImplemented
 
+
+class CustomizedContent(Content, ABC):
+    """
+        Application Customized message
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+        data format: {
+            "type" : i2s(0xCC),
+            "sn"   : 12345,
+
+            "app"   : "{APP_ID}",  // application (e.g.: "chat.dim.sechat")
+            "mod"   : "{MODULE}",  // module name (e.g.: "drift_bottle")
+            "act"   : "{ACTION}",  // action name (e.g.: "throw")
+            "extra" : info         // action parameters
+        }
+    """
+
     @property
     @abstractmethod
     def module(self) -> str:
@@ -204,16 +216,22 @@ class AppContent(Content, ABC):
         raise NotImplemented
 
     #
-    #   Factory
+    #   Factory method
     #
     @classmethod
     def create(cls, app: str, mod: str, act: str):
-        return ApplicationContent(app=app, mod=mod, act=act)
+        return AppCustomizedContent(app=app, mod=mod, act=act)
+```
+
+```python
+from typing import Dict
+
+from dimp import *
 
 
-class ApplicationContent(BaseContent, AppContent):
+class AppCustomizedContent(BaseContent, AppContent, CustomizedContent):
 
-    def __init__(self, content: Dict[str, Any] = None,
+    def __init__(self, content: Dict = None,
                  msg_type: str = None,
                  app: str = None, mod: str = None, act: str = None):
         if content is None:
@@ -221,7 +239,7 @@ class ApplicationContent(BaseContent, AppContent):
             assert app is not None and mod is not None and act is not None, \
                 'customized content error: %s, %s, %s, %s' % (msg_type, app, mod, act)
             if msg_type is None:
-                msg_type = ContentType.APPLICATION
+                msg_type = ContentType.CUSTOMIZED
             super().__init__(None, msg_type)
             self['app'] = app
             self['mod'] = mod
@@ -245,11 +263,11 @@ class ApplicationContent(BaseContent, AppContent):
         return self.get_str(key='act', default='')
 ```
 
-### extends ID Address
+### Extends ID Address
 
 * Examples in [dim plugins](https://pypi.org/project/dimplugins)
 
 ----
 
-Copyright © 2018-2025 Albert Moky
+Copyright © 2018-2026 Albert Moky
 [![Followers](https://img.shields.io/github/followers/moky)](https://github.com/moky?tab=followers)

{dimp-2.3.3 → dimp-2.4.0}/dimp/__init__.py

@@ -28,18 +28,12 @@
 # SOFTWARE.
 # ==============================================================================
 
-from mkm.types import *
-from mkm.format import *
-from mkm.crypto import *
-from mkm import *
-from dkd import *
-
-from .protocol.base import CommandFactory
-from .protocol import *
+from .format import *
 from .crypto import *
+from .protocol import *
 from .mkm import *
 from .dkd import *
-from .msg import *
+from .ext import *
 
 
 name = "DIMP"
@@ -53,6 +47,7 @@ __all__ = [
     'URI', 'DateTime',
 
     'Converter', 'DataConverter', 'BaseConverter',
+
     'Copier',
     'Wrapper', 'Stringer', 'Mapper',
     'ConstantString',  # 'String',
@@ -65,7 +60,6 @@ __all__ = [
     'DataCoder', 'Hex', 'Base58', 'Base64',
     'ObjectCoder', 'JSON',
     'MapCoder', 'JSONMap',
-    'ListCoder', 'JSONList',
     'StringCoder', 'UTF8',
 
     'hex_encode', 'hex_decode',
@@ -74,17 +68,50 @@ __all__ = [
     'json_encode', 'json_decode',
     'utf8_encode', 'utf8_decode',
 
-    'TransportableData', 'TransportableDataFactory',
-    'PortableNetworkFile', 'PortableNetworkFileFactory',
+    'TransportableResource',
+    'TransportableData',
+
+    'TransportableDataFactory',
+
+    'TransportableDataHelper',
+    'FormatExtensions', 'shared_format_extensions',
+
+    'Header', 'DataURI',
 
     #
-    #   Digest
+    #   TED
     #
 
-    'DataDigester',
-    'MD5', 'SHA1', 'SHA256', 'KECCAK256', 'RIPEMD160',
+    'EncodeAlgorithms',
+
+    'BaseString', 'BaseData',
+
+    'Base64Data', 'PlainData',
+    'EmbedData',
+
+    #
+    #   PNF
+    #
+
+    'TransportableFile', 'TransportableFileFactory',
+    # 'TransportableFileHelper', 'TransportableFileExtension',
+    'TransportableFileWrapper', 'TransportableFileWrapperFactory',
+    # 'TransportableFileWrapperExtension',
+
+    'PortableNetworkFile',
+    'PortableNetworkFileWrapper',
+
+
+    # ================================================================
+
+
+    #
+    #   Digest
+    #
 
-    'md5', 'sha1', 'sha256', 'keccak256', 'ripemd160',
+    'MessageDigester',
+    'SHA256', 'KECCAK256', 'RIPEMD160',
+    'sha256', 'keccak256', 'ripemd160',
 
     #
     #   Crypto
@@ -97,102 +124,153 @@ __all__ = [
 
     'SymmetricKeyFactory', 'PrivateKeyFactory', 'PublicKeyFactory',
 
-    'BaseKey', 'BaseSymmetricKey',
-    'BaseAsymmetricKey', 'BasePublicKey', 'BasePrivateKey',
+    'SymmetricKeyHelper', 'PublicKeyHelper', 'PrivateKeyHelper',
 
-    'BaseDataWrapper',
-    'BaseFileWrapper',
+    'SymmetricKeyExtension', 'PublicKeyExtension', 'PrivateKeyExtension',
+    'CryptoExtensions', 'shared_crypto_extensions',
 
     #
-    #   Algorithm
+    #   Algorithms
     #
+
     'AsymmetricAlgorithms', 'SymmetricAlgorithms',
-    'EncodeAlgorithms',
+
+
+    # ================================================================
+
 
     #
-    #   MingKeMing
+    #   Ming-Ke-Ming
     #
 
     'EntityType',
-    'Address',
-    'ID',
-    'Meta',
-    'Document', 'Visa', 'Bulletin',
-
-    'MetaType', 'DocumentType',
+    'Address', 'ID',
+    'Meta', 'TAI', 'Document',
 
-    'AddressFactory',
-    'IDFactory',
-    'MetaFactory',
-    'DocumentFactory',
+    'AddressFactory', 'IDFactory',
+    'MetaFactory', 'DocumentFactory',
 
-    'Identifier',
-    'ANYONE', 'EVERYONE', 'FOUNDER',
     'ANYWHERE', 'EVERYWHERE',
-    # 'BroadcastAddress',
+    'ANYONE', 'EVERYONE', 'FOUNDER',
+    'BroadcastAddress', 'Identifier',
 
-    'BaseMeta',
-    'BaseDocument', 'BaseVisa', 'BaseBulletin',
+    'AddressHelper', 'IDHelper',
+    'MetaHelper', 'DocumentHelper',
+
+    'AddressExtension', 'IDExtension',
+    'MetaExtension', 'DocumentExtension',
+    'AccountExtensions', 'shared_account_extensions',
 
     #
-    #   DaoKeDao
+    #   Dao-Ke-Dao
     #
 
-    'ContentType',
-    'Content',
-    'Envelope',
+    'Content', 'Envelope',
     'Message',
     'InstantMessage', 'SecureMessage', 'ReliableMessage',
 
-    # contents
+    'ContentFactory', 'EnvelopeFactory',
+    'InstantMessageFactory', 'SecureMessageFactory', 'ReliableMessageFactory',
+
+    'ContentHelper', 'EnvelopeHelper',
+    'InstantMessageHelper', 'SecureMessageHelper', 'ReliableMessageHelper',
+
+    'ContentExtension',
+    'InstantMessageExtension', 'SecureMessageExtension', 'ReliableMessageExtension',
+    'MessageExtensions', 'shared_message_extensions',
+
+    #
+    #   Core Protocols
+    #
+
+    'MetaType',
+    'DocumentType',
+    'Visa', 'Bulletin',
+
+    'ContentType',
+
+    'Command', 'CommandFactory',
+
+    # 'CommandHelper', 'GeneralCommandHelper',
+    # 'CommandExtension', 'CmdExtension',
+
+    #
+    #  Contents
+    #
+
     'TextContent', 'PageContent', 'NameCard',
-    'ForwardContent', 'CombineContent', 'ArrayContent',
-    'FileContent', 'ImageContent', 'AudioContent', 'VideoContent',
     'MoneyContent', 'TransferContent',
+    'FileContent', 'ImageContent', 'AudioContent', 'VideoContent',
+    'ForwardContent', 'CombineContent', 'ArrayContent',
     'QuoteContent',
-    'CustomizedContent',
+    # 'QuoteHelper', 'QuotePurifier', 'QuoteExtension',
+
+    #
+    #  Commands
+    #
 
-    # commands
-    'Command',
     'MetaCommand', 'DocumentCommand',
     'ReceiptCommand',
 
-    # group history
     'HistoryCommand', 'GroupCommand',
-    'InviteCommand', 'ExpelCommand', 'JoinCommand', 'QuitCommand', 'QueryCommand', 'ResetCommand',
-    'HireCommand', 'FireCommand', 'ResignCommand',
+    'InviteCommand', 'ExpelCommand', 'JoinCommand', 'QuitCommand', 'ResetCommand',
+
+
+    # ================================================================
+
+
+    #
+    #   Account Implementations
+    #
+
+    'BaseMeta',
+    'BaseDocument', 'BaseVisa', 'BaseBulletin',
+
+    #
+    #   Content Implementations
+    #
+
+    'BaseContent', 'BaseCommand',
+    # 'CommandHelper', 'GeneralCommandHelper',
+    # 'CommandExtension', 'CmdExtension',
 
-    # extend contents
-    'BaseContent',
     'BaseTextContent', 'WebPageContent', 'NameCardContent',
-    'SecretContent', 'CombineForwardContent', 'ListContent',
-    'BaseFileContent', 'ImageFileContent', 'AudioFileContent', 'VideoFileContent',
     'BaseMoneyContent', 'TransferMoneyContent',
+    'BaseFileContent', 'ImageFileContent', 'AudioFileContent', 'VideoFileContent',
+    'SecretContent', 'CombineForwardContent', 'ListContent',
     'BaseQuoteContent',
-    'AppCustomizedContent',
+    # 'QuoteHelper', 'QuotePurifier', 'QuoteExtension',
 
-    # extend commands
-    'BaseCommand',
     'BaseMetaCommand', 'BaseDocumentCommand',
     'BaseReceiptCommand',
-
-    # extend group history
     'BaseHistoryCommand', 'BaseGroupCommand',
-    'InviteGroupCommand', 'ExpelGroupCommand', 'JoinGroupCommand',
-    'QuitGroupCommand', 'QueryGroupCommand', 'ResetGroupCommand',
-    'HireGroupCommand', 'FireGroupCommand', 'ResignGroupCommand',
+    'InviteGroupCommand', 'ExpelGroupCommand', 'JoinGroupCommand', 'QuitGroupCommand', 'ResetGroupCommand',
 
     #
-    #   Message
+    #   Message Implementations
     #
 
     'MessageEnvelope',
     'BaseMessage',
     'PlainMessage', 'EncryptedMessage', 'NetworkMessage',
 
-    # factories
-    'ContentFactory', 'CommandFactory',
-    'EnvelopeFactory',
-    'InstantMessageFactory', 'SecureMessageFactory', 'ReliableMessageFactory',
+
+    # ================================================================
+
+
+    'GeneralCryptoHelper', 'GeneralCryptoExtension',
+    'GeneralAccountHelper', 'GeneralAccountExtension',
+
+    'GeneralMessageHelper', 'GeneralMessageExtension',
+
+    'TransportableFileHelper',
+    'TransportableFileExtension',
+    'TransportableFileWrapperExtension',
+
+    'CommandHelper', 'GeneralCommandHelper',
+    'CommandExtension', 'CmdExtension',
+
+    'QuoteHelper', 'QuotePurifier',
+    'QuoteExtension',
 
 ]

{dimp-2.3.3 → dimp-2.4.0}/dimp/crypto/__init__.py

@@ -28,26 +28,21 @@
 # SOFTWARE.
 # ==============================================================================
 
+from mkm.digest import *
 from mkm.crypto import *
 
 from .algorithms import AsymmetricAlgorithms, SymmetricAlgorithms
-from .algorithms import EncodeAlgorithms
 
-from .keys import BaseKey, BaseSymmetricKey
-from .keys import BaseAsymmetricKey, BasePublicKey, BasePrivateKey
-
-from .ted import BaseDataWrapper
-from .pnf import BaseFileWrapper
 
 __all__ = [
 
     #
-    #   Data Digest
+    #   Digest
     #
 
-    'DataDigester',
-    'MD5', 'SHA1', 'SHA256', 'KECCAK256', 'RIPEMD160',
-    'md5', 'sha1', 'sha256', 'keccak256', 'ripemd160',
+    'MessageDigester',
+    'SHA256', 'KECCAK256', 'RIPEMD160',
+    'sha256', 'keccak256', 'ripemd160',
 
     #
     #   Crypto
@@ -60,22 +55,15 @@ __all__ = [
 
     'SymmetricKeyFactory', 'PrivateKeyFactory', 'PublicKeyFactory',
 
-    #
-    #   Algorithm
-    #
-    'AsymmetricAlgorithms', 'SymmetricAlgorithms',
-    'EncodeAlgorithms',
+    # 'SymmetricKeyHelper', 'PublicKeyHelper', 'PrivateKeyHelper',
 
-    #
-    #   Base Keys
-    #
-    'BaseKey', 'BaseSymmetricKey',
-    'BaseAsymmetricKey', 'BasePublicKey', 'BasePrivateKey',
+    # 'SymmetricKeyExtension', 'PublicKeyExtension', 'PrivateKeyExtension',
+    # 'CryptoExtensions', 'shared_crypto_extensions',
 
-    #
-    #   TED & PNF
-    #
-    'BaseDataWrapper',
-    'BaseFileWrapper',
+
+    # ----------------------------------------------------------------
+
+
+    'AsymmetricAlgorithms', 'SymmetricAlgorithms',
 
 ]