ddns 4.0.2__py2.py3-none-any.whl → 4.1.0b2__py2.py3-none-any.whl

ddns/__builtins__.pyi

@@ -0,0 +1,5 @@
+# coding=utf-8
+# flake8: noqa: F401
+from typing import *
+from .provider import SimpleProvider
+import logging

ddns/__init__.py

@@ -6,14 +6,7 @@ ddns Package
 __description__ = "automatically update DNS records to my IP [域名自动指向本机IP]"
 
 # 编译时，版本会被替换
-__version__ = "4.0.2"
+__version__ = "4.1.0b2"
 
 # 时间也会被替换掉
-build_date = "2025-06-25T01:07:58Z"
-
-__doc__ = """
-ddns [v{}@{}]
-(i) homepage or docs [文档主页]: https://ddns.newfuture.cc/
-(?) issues or bugs [问题和反馈]: https://github.com/NewFuture/DDNS/issues
-Copyright (c) New Future (MIT License)
-""".format(__version__, build_date)
+build_date = "2025-07-15T02:27:02Z"

ddns/__main__.py

@@ -1,187 +1,118 @@
 # -*- coding:utf-8 -*-
 """
 DDNS
-@author: New Future
-@modified: rufengsuixing
+@author: NewFuture, rufengsuixing
 """
 
-from os import path, environ, name as os_name
 from io import TextIOWrapper
 from subprocess import check_output
-from tempfile import gettempdir
-from logging import basicConfig, info, warning, error, debug, INFO
-
+from logging import getLogger
 import sys
 
-from .__init__ import __version__, __description__, __doc__, build_date
-from .util import ip
-from .util.cache import Cache
-from .util.config import init_config, get_config
-
-environ["DDNS_VERSION"] = __version__
-
+from .__init__ import __version__, __description__, build_date
+from .config import load_config, Config  # noqa: F401
+from .provider import get_provider_class, SimpleProvider
+from . import ip
+from .cache import Cache
 
-def is_false(value):
-    """
-    判断值是否为 False
-    字符串 'false', 或者 False, 或者 'none';
-    0 不是 False
-    """
-    if isinstance(value, str):
-        return value.strip().lower() in ['false', 'none']
-    return value is False
+logger = getLogger()
+# Set user agent for All Providers
+SimpleProvider.user_agent = SimpleProvider.user_agent.format(version=__version__)
 
 
-def get_ip(ip_type, index="default"):
+def get_ip(ip_type, rules):
     """
     get IP address
     """
-    # CN: 捕获异常
-    # EN: Catch exceptions
-    value = None
-    try:
-        debug("get_ip(%s, %s)", ip_type, index)
-        if is_false(index):  # disabled
-            return False
-        elif isinstance(index, list):  # 如果获取到的规则是列表，则依次判断列表中每一个规则，直到获取到IP
-            for i in index:
-                value = get_ip(ip_type, i)
-                if value:
-                    break
-        elif str(index).isdigit():  # 数字 local eth
-            value = getattr(ip, "local_v" + ip_type)(index)
-        elif index.startswith('cmd:'):  # cmd
-            value = str(check_output(index[4:]).strip().decode('utf-8'))
-        elif index.startswith('shell:'):  # shell
-            value = str(check_output(
-                index[6:], shell=True).strip().decode('utf-8'))
-        elif index.startswith('url:'):  # 自定义 url
-            value = getattr(ip, "public_v" + ip_type)(index[4:])
-        elif index.startswith('regex:'):  # 正则 regex
-            value = getattr(ip, "regex_v" + ip_type)(index[6:])
-        else:
-            value = getattr(ip, index + "_v" + ip_type)()
-    except Exception as e:
-        error("Failed to get %s address: %s", ip_type, e)
-    return value
-
-
-def change_dns_record(dns, proxy_list, **kw):
-    for proxy in proxy_list:
-        if not proxy or (proxy.upper() in ['DIRECT', 'NONE']):
-            dns.Config.PROXY = None
-        else:
-            dns.Config.PROXY = proxy
-        record_type, domain = kw['record_type'], kw['domain']
-        info("%s(%s) ==> %s [via %s]", domain, record_type, kw['ip'], proxy)
+    if rules is False:  # disabled
+        return False
+    for i in rules:
         try:
-            return dns.update_record(domain, kw['ip'], record_type=record_type)
+            logger.debug("get_ip:(%s, %s)", ip_type, i)
+            if str(i).isdigit():  # 数字 local eth
+                return getattr(ip, "local_v" + ip_type)(i)
+            elif i.startswith("cmd:"):  # cmd
+                return str(check_output(i[4:]).strip().decode("utf-8"))
+            elif i.startswith("shell:"):  # shell
+                return str(check_output(i[6:], shell=True).strip().decode("utf-8"))
+            elif i.startswith("url:"):  # 自定义 url
+                return getattr(ip, "public_v" + ip_type)(i[4:])
+            elif i.startswith("regex:"):  # 正则 regex
+                return getattr(ip, "regex_v" + ip_type)(i[6:])
+            else:
+                return getattr(ip, i + "_v" + ip_type)()
         except Exception as e:
-            error("Failed to update %s record for %s: %s", record_type, domain, e)
-    return False
+            logger.error("Failed to get %s address: %s", ip_type, e)
+    return None
 
 
-def update_ip(ip_type, cache, dns, proxy_list):
+def update_ip(dns, cache, index_rule, domains, record_type, config):
+    # type: (SimpleProvider, Cache | None, list[str]|bool, list[str], str, Config) -> bool | None
     """
-    更新IP
+    更新IP并变更DNS记录
     """
-    ipname = 'ipv' + ip_type
-    domains = get_config(ipname)
     if not domains:
         return None
-    if not isinstance(domains, list):
-        domains = domains.strip('; ').replace(',', ';').replace(' ', ';').split(';')
 
-    index_rule = get_config('index' + ip_type, "default")
+    ip_type = "4" if record_type == "A" else "6"
     address = get_ip(ip_type, index_rule)
     if not address:
-        error('Fail to get %s address!', ipname)
+        logger.error("Fail to get %s address!", ip_type)
         return False
 
-    if cache and (address == cache.get(ipname)):
-        info('%s address not changed, using cache.', ipname)
-        return True
-
-    record_type = 'A' if ip_type == '4' else 'AAAA'
     update_success = False
+
     for domain in domains:
         domain = domain.lower()
-        if change_dns_record(dns, proxy_list, domain=domain, ip=address, record_type=record_type):
+        cache_key = "{}:{}".format(domain, record_type)
+        if cache and cache.get(cache_key) == address:
+            logger.info("%s[%s] address not changed, using cache: %s", domain, record_type, address)
             update_success = True
-
-    if isinstance(cache, dict):
-        cache[ipname] = update_success and address
-
+        else:
+            try:
+                result = dns.set_record(domain, address, record_type=record_type, ttl=config.ttl, line=config.line)
+                if result:
+                    logger.warning("set %s[IPv%s]: %s successfully.", domain, ip_type, address)
+                    update_success = True
+                    if isinstance(cache, dict):
+                        cache[cache_key] = address
+                else:
+                    logger.error("Failed to update %s record for %s", record_type, domain)
+            except Exception as e:
+                logger.exception("Failed to update %s record for %s: %s", record_type, domain, e)
     return update_success
 
 
-def main():
+def run(config):
+    # type: (Config) -> bool
     """
-    更新
+    Run the DDNS update process
     """
+    # 设置IP模块的SSL验证配置
+    ip.ssl_verify = config.ssl
+
+    # dns provider class
+    provider_class = get_provider_class(config.dns)
+    dns = provider_class(
+        config.id, config.token, endpoint=config.endpoint, logger=logger, proxy=config.proxy, verify_ssl=config.ssl
+    )
+    cache = Cache.new(config.cache, config.md5(), logger)
+    return (
+        update_ip(dns, cache, config.index4, config.ipv4, "A", config) is not False
+        and update_ip(dns, cache, config.index6, config.ipv6, "AAAA", config) is not False
+    )
+
+
+def main():
     encode = sys.stdout.encoding
-    if encode is not None and encode.lower() != 'utf-8' and hasattr(sys.stdout, 'buffer'):
+    if encode is not None and encode.lower() != "utf-8" and hasattr(sys.stdout, "buffer"):
         # 兼容windows 和部分ASCII编码的老旧系统
-        sys.stdout = TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
-        sys.stderr = TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
-    init_config(__description__, __doc__, __version__, build_date)
-
-    log_level = get_config('log.level', INFO)
-    log_format = get_config('log.format')
-    if log_format:
-        # A custom log format is already set; no further action is required.
-        pass
-    elif log_level < INFO:
-        # Override log format in debug mode to include filename and line number for detailed debugging
-        log_format = '%(asctime)s %(levelname)s [%(module)s.%(funcName)s](%(filename)s:%(lineno)d): %(message)s'
-    elif log_level > INFO:
-        log_format = '%(asctime)s %(levelname)s: %(message)s'
-    else:
-        log_format = '%(asctime)s %(levelname)s [%(module)s]: %(message)s'
-    basicConfig(
-        level=log_level,
-        format=log_format,
-        datefmt=get_config('log.datefmt', '%Y-%m-%dT%H:%M:%S'),
-        filename=get_config('log.file'),
-    )
+        sys.stdout = TextIOWrapper(sys.stdout.buffer, encoding="utf-8")
+        sys.stderr = TextIOWrapper(sys.stderr.buffer, encoding="utf-8")
+    logger.name = "ddns"
+    config = load_config(__description__, __version__, build_date)
+    run(config)
+
 
-    info("DDNS[ %s ] run: %s %s", __version__, os_name, sys.platform)
-
-    # Dynamically import the dns module as configuration
-    dns_provider = str(get_config('dns', 'dnspod').lower())
-    # dns_module = __import__(
-    #     '.dns', fromlist=[dns_provider], package=__package__)
-    dns = getattr(__import__('ddns.provider', fromlist=[dns_provider]), dns_provider)
-    # dns = getattr(dns_module, dns_provider)
-    dns.Config.ID = get_config('id')
-    dns.Config.TOKEN = get_config('token')
-    dns.Config.TTL = get_config('ttl')
-
-    if get_config("config"):
-        info('loaded Config from: %s', path.abspath(get_config('config')))
-
-    proxy = get_config('proxy') or 'DIRECT'
-    proxy_list = proxy if isinstance(
-        proxy, list) else proxy.strip(';').replace(',', ';').split(';')
-
-    cache_config = get_config('cache', True)
-    if cache_config is False:
-        cache = cache_config
-    elif cache_config is True:
-        cache = Cache(path.join(gettempdir(), 'ddns.cache'))
-    else:
-        cache = Cache(cache_config)
-
-    if cache is False:
-        info('Cache is disabled!')
-    elif not get_config('config_modified_time') or get_config('config_modified_time') >= cache.time:
-        warning('Cache file is outdated.')
-        cache.clear()
-    else:
-        debug('Cache is empty.')
-    update_ip('4', cache, dns, proxy_list)
-    update_ip('6', cache, dns, proxy_list)
-
-
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()

ddns/cache.py

@@ -0,0 +1,183 @@
+# -*- coding: utf-8 -*-
+"""
+cache module
+文件缓存
+"""
+
+from logging import getLogger, Logger  # noqa: F401
+from os import path, stat
+from json import load, dump
+from tempfile import gettempdir
+from time import time
+
+
+class Cache(dict):
+    """
+    using file to Cache data as dictionary
+    """
+
+    def __init__(self, path, logger=None, sync=False):
+        # type: (str, Logger | None, bool) -> None
+        super(Cache, self).__init__()
+        self.__filename = path
+        self.__sync = sync
+        self.__time = time()
+        self.__changed = False
+        self.__logger = (logger or getLogger()).getChild("Cache")
+        self.load()
+
+    @property
+    def time(self):
+        """
+        缓存修改时间
+        """
+        return self.__time or 0
+
+    def load(self, file=None):
+        """
+        load data from path
+        """
+        if not file:
+            file = self.__filename
+
+        self.__logger.debug("load cache data from %s", file)
+        if file:
+            try:
+                with open(file, "r") as data:
+                    loaded_data = load(data)
+                    self.clear()
+                    self.update(loaded_data)
+                    self.__time = stat(file).st_mtime
+                    return self
+            except (IOError, OSError):
+                self.__logger.info("cache file not exist or cannot be opened")
+            except ValueError:
+                pass
+            except Exception as e:
+                self.__logger.warning(e)
+        else:
+            self.__logger.info("cache file not exist")
+
+        self.clear()
+        self.__time = time()
+        self.__changed = True
+        return self
+
+    def sync(self):
+        """Sync the write buffer with the cache files and clear the buffer."""
+        if self.__changed and self.__filename:
+            with open(self.__filename, "w") as data:
+                # 只保存非私有字段（不以__开头的字段）
+                filtered_data = {k: v for k, v in super(Cache, self).items() if not k.startswith("__")}
+                dump(filtered_data, data, separators=(",", ":"))
+                self.__logger.debug("save cache data to %s", self.__filename)
+            self.__time = time()
+            self.__changed = False
+        return self
+
+    def close(self):
+        """Sync the write buffer, then close the cache.
+        If a closed :class:`FileCache` object's methods are called, a
+        :exc:`ValueError` will be raised.
+        """
+        if self.__filename:
+            self.sync()
+        self.__filename = None
+        self.__time = None
+        self.__sync = False
+
+    def __update(self):
+        self.__changed = True
+        if self.__sync:
+            self.sync()
+        else:
+            self.__time = time()
+
+    def clear(self):
+        # 只清除非私有字段（不以__开头的字段）
+        keys_to_remove = [key for key in super(Cache, self).keys() if not key.startswith("__")]
+        if keys_to_remove:
+            for key in keys_to_remove:
+                super(Cache, self).__delitem__(key)
+            self.__update()
+
+    def get(self, key, default=None):
+        """
+        获取指定键的值，如果键不存在则返回默认值
+        :param key: 键
+        :param default: 默认值
+        :return: 键对应的值或默认值
+        """
+        if key is None and default is None:
+            return {k: v for k, v in super(Cache, self).items() if not k.startswith("__")}
+        return super(Cache, self).get(key, default)
+
+    def __setitem__(self, key, value):
+        if self.get(key) != value:
+            super(Cache, self).__setitem__(key, value)
+            # 私有字段（以__开头）不触发同步
+            if not key.startswith("__"):
+                self.__update()
+
+    def __delitem__(self, key):
+        # 检查键是否存在，如果不存在则直接返回，不抛错
+        if not super(Cache, self).__contains__(key):
+            return
+        super(Cache, self).__delitem__(key)
+        # 私有字段（以__开头）不触发同步
+        if not key.startswith("__"):
+            self.__update()
+
+    def __getitem__(self, key):
+        return super(Cache, self).__getitem__(key)
+
+    def __iter__(self):
+        # 只迭代非私有字段（不以__开头的字段）
+        for key in super(Cache, self).__iter__():
+            if not key.startswith("__"):
+                yield key
+
+    def __items__(self):
+        # 只返回非私有字段（不以__开头的字段）
+        return ((key, value) for key, value in super(Cache, self).items() if not key.startswith("__"))
+
+    def __len__(self):
+        # 不计算以__开头的私有字段
+        return len([key for key in super(Cache, self).keys() if not key.startswith("__")])
+
+    def __contains__(self, key):
+        return super(Cache, self).__contains__(key)
+
+    def __str__(self):
+        return super(Cache, self).__str__()
+
+    def __del__(self):
+        self.close()
+
+    @staticmethod
+    def new(config_cache, hash, logger):
+        # type: (str|bool, str, Logger) -> Cache|None
+        """
+        new cache from a file path.
+        :param path: Path to the cache file.
+        :param logger: Optional logger for debug messages.
+        :return: Cache instance with loaded data.
+        """
+        if config_cache is False:
+            cache = None
+        elif config_cache is True:
+            cache_path = path.join(gettempdir(), "ddns.%s.cache" % hash)
+            cache = Cache(cache_path, logger)
+        else:
+            cache = Cache(config_cache, logger)
+
+        if cache is None:
+            logger.debug("Cache is disabled!")
+        elif cache.time + 72 * 3600 < time():  # 72小时有效期
+            logger.info("Cache file is outdated.")
+            cache.clear()
+        elif len(cache) == 0:
+            logger.debug("Cache is empty.")
+        else:
+            logger.debug("Cache loaded with %d entries.", len(cache))
+        return cache

ddns/{util/ip.py → ip.py}

@@ -4,16 +4,17 @@ from re import compile
 from os import name as os_name, popen
 from socket import socket, getaddrinfo, gethostname, AF_INET, AF_INET6, SOCK_DGRAM
 from logging import debug, error
-try:  # python3
-    from urllib.request import urlopen, Request
-except ImportError:  # python2
-    from urllib2 import urlopen, Request
+
+from .util.http import send_http_request
+
+# 模块级别的SSL验证配置，默认使用auto模式
+ssl_verify = "auto"
 
 # IPV4正则
-IPV4_REG = r'((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])'
+IPV4_REG = r"((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])"
 # IPV6正则
 # https://community.helpsystems.com/forums/intermapper/miscellaneous-topics/5acc4fcf-fa83-e511-80cf-0050568460e4
-IPV6_REG = r'((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))'  # noqa: E501
+IPV6_REG = r"((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))"  # noqa: E501
 
 
 def default_v4():  # 默认连接外网的ipv4
@@ -26,7 +27,7 @@ def default_v4():  # 默认连接外网的ipv4
 
 def default_v6():  # 默认连接外网的ipv6
     s = socket(AF_INET6, SOCK_DGRAM)
-    s.connect(('1:1:1:1:1:1:1:1', 8))
+    s.connect(("1:1:1:1:1:1:1:1", 8))
     ip = s.getsockname()[0]
     s.close()
     return ip
@@ -47,11 +48,15 @@ def local_v4(i=0):  # 本地ipv4地址
 def _open(url, reg):
     try:
         debug("open: %s", url)
-        res = urlopen(
-            Request(url, headers={'User-Agent': 'Mozilla/5.0 ddns'}),  timeout=60
-        ).read().decode('utf8', 'ignore')
-        debug("response: %s",  res)
-        return compile(reg).search(res).group()
+        response = send_http_request(
+            method="GET", url=url, headers={"User-Agent": "Mozilla/5.0 ddns"}, verify_ssl=ssl_verify
+        )
+        res = response.body
+        debug("response: %s", res)
+        match = compile(reg).search(res)
+        if match:
+            return match.group()
+        error("No match found in response: %s", res)
     except Exception as e:
         error(e)
 
@@ -69,10 +74,10 @@ def _ip_regex_match(parrent_regex, match_regex):
     ip_pattern = compile(parrent_regex)
     matcher = compile(match_regex)
 
-    if os_name == 'nt':  # windows:
-        cmd = 'ipconfig'
+    if os_name == "nt":  # windows:
+        cmd = "ipconfig"
     else:
-        cmd = 'ip address || ifconfig 2>/dev/null'
+        cmd = "ip address || ifconfig 2>/dev/null"
 
     for s in popen(cmd).readlines():
         addr = ip_pattern.search(s)
@@ -81,16 +86,16 @@ def _ip_regex_match(parrent_regex, match_regex):
 
 
 def regex_v4(reg):  # ipv4 正则提取
-    if os_name == 'nt':  # Windows: IPv4 xxx: 192.168.1.2
-        regex_str = r'IPv4 .*: ((?:\d{1,3}\.){3}\d{1,3})\W'
+    if os_name == "nt":  # Windows: IPv4 xxx: 192.168.1.2
+        regex_str = r"IPv4 .*: ((?:\d{1,3}\.){3}\d{1,3})\W"
     else:
-        regex_str = r'inet (?:addr\:)?((?:\d{1,3}\.){3}\d{1,3})[\s/]'
+        regex_str = r"inet (?:addr\:)?((?:\d{1,3}\.){3}\d{1,3})[\s/]"
     return _ip_regex_match(regex_str, reg)
 
 
 def regex_v6(reg):  # ipv6 正则提取
-    if os_name == 'nt':  # Windows: IPv4 xxx: ::1
-        regex_str = r'IPv6 .*: ([\:\dabcdef]*)?\W'
+    if os_name == "nt":  # Windows: IPv4 xxx: ::1
+        regex_str = r"IPv6 .*: ([\:\dabcdef]*)?\W"
     else:
-        regex_str = r'inet6 (?:addr\:\s*)?([\:\dabcdef]*)?[\s/%]'
+        regex_str = r"inet6 (?:addr\:\s*)?([\:\dabcdef]*)?[\s/%]"
     return _ip_regex_match(regex_str, reg)

ddns/provider/__init__.py

@@ -0,0 +1,79 @@
+# coding=utf-8
+from ._base import SimpleProvider
+from .alidns import AlidnsProvider
+from .aliesa import AliesaProvider
+from .callback import CallbackProvider
+from .cloudflare import CloudflareProvider
+from .debug import DebugProvider
+from .dnscom import DnscomProvider
+from .dnspod import DnspodProvider
+from .dnspod_com import DnspodComProvider
+from .edgeone import EdgeOneProvider
+from .he import HeProvider
+from .huaweidns import HuaweiDNSProvider
+from .namesilo import NamesiloProvider
+from .noip import NoipProvider
+from .tencentcloud import TencentCloudProvider
+
+__all__ = ["SimpleProvider", "get_provider_class"]
+
+
+def get_provider_class(provider_name):
+    # type: (str) -> type[SimpleProvider]
+    """
+    获取指定的DNS提供商类
+
+    :param provider_name: 提供商名称
+    :return: 对应的DNS提供商类
+    """
+    provider_name = str(provider_name).lower()
+    mapping = {
+        # dnspod.cn
+        "dnspod": DnspodProvider,
+        "dnspod_cn": DnspodProvider,  # 兼容旧的dnspod_cn
+        # dnspod.com
+        "dnspod_com": DnspodComProvider,
+        "dnspod_global": DnspodComProvider,  # 兼容旧的dnspod_global
+        # tencent cloud dnspod
+        "tencentcloud": TencentCloudProvider,
+        "tencent": TencentCloudProvider,  # 兼容tencent
+        "qcloud": TencentCloudProvider,  # 兼容qcloud
+        # tencent cloud edgeone
+        "edgeone": EdgeOneProvider,
+        "teo": EdgeOneProvider,  # 兼容teo (EdgeOne产品的API名称)
+        "tencentedgeone": EdgeOneProvider,  # 兼容tencentedgeone
+        # cloudflare
+        "cloudflare": CloudflareProvider,
+        # aliyun alidns
+        "alidns": AlidnsProvider,
+        "aliyun": AlidnsProvider,  # 兼容aliyun
+        # aliyun esa
+        "aliesa": AliesaProvider,
+        "esa": AliesaProvider,  # 兼容esa
+        # dns.com
+        "dnscom": DnscomProvider,
+        "51dns": DnscomProvider,  # 兼容51dns
+        "dns_com": DnscomProvider,  # 兼容dns_com
+        # he.net
+        "he": HeProvider,
+        "he_net": HeProvider,  # 兼容he.net
+        # huawei
+        "huaweidns": HuaweiDNSProvider,
+        "huawei": HuaweiDNSProvider,  # 兼容huawei
+        "huaweicloud": HuaweiDNSProvider,
+        # namesilo
+        "namesilo": NamesiloProvider,
+        "namesilo_com": NamesiloProvider,  # 兼容namesilo.com
+        # no-ip
+        "noip": NoipProvider,
+        "no-ip": NoipProvider,  # 兼容no-ip
+        "noip_com": NoipProvider,  # 兼容noip.com
+        # callback
+        "callback": CallbackProvider,
+        "webhook": CallbackProvider,  # 兼容
+        "http": CallbackProvider,  # 兼容
+        # debug
+        "print": DebugProvider,
+        "debug": DebugProvider,  # 兼容print
+    }
+    return mapping.get(provider_name)  # type: ignore[return-value]