ddns 4.0.0b5__tar.gz → 4.0.0b7__tar.gz

{ddns-4.0.0b5 → ddns-4.0.0b7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: ddns
-Version: 4.0.0b5
-Summary: automatically update DNS records to dynamic local IP [自动更新DNS记录指向本地IP]
+Version: 4.0.0b7
+Summary: automatically update DNS records to my IP [域名自动指向本机IP]
 Home-page: https://ddns.newfuture.cc
 Author: NewFuture
 Author-email: python@newfuture.cc
@@ -60,9 +60,9 @@ Dynamic: summary
   - [二进制文件](https://github.com/NewFuture/DDNS/releases/latest) ![cross platform](https://img.shields.io/badge/system-windows_%7C%20linux_%7C%20mac-success.svg?style=social)
   
 - 配置方式:
-  - [命令行参数](#详细配置)
-  - [JSON 配置文件](#详细配置)
-  - [环境变量配置](doc/env.md) 📖
+  - [命令行参数](doc/cli.md)
+  - [JSON 配置文件](doc/json.md)
+  - [环境变量配置](doc/env.md)
 
 - 域名支持:
   - 多个域名支持
@@ -155,12 +155,27 @@ Dynamic: summary
 
 ## 详细配置
 
-所有字段可通过三种方式进行配置
+所有字段可通过三种方式进行配置，优先级为：**命令行参数 > JSON配置文件 > 环境变量**
 
-1. 命令行参数 `ddns --key=value`（`ddns -h` 查看详情），优先级最高
-2. JSON 配置文件（值为 null 认为是有效值，会覆盖环境变量的设置，如果没有对应的 key 则会尝试使用环境变量）
+1. [命令行参数](doc/cli.md) `ddns --key=value`（`ddns -h` 查看详情），优先级最高
+2. [JSON 配置文件](doc/json.md)（值为 null 认为是有效值，会覆盖环境变量的设置，如果没有对应的 key 则会尝试使用环境变量）
 3. 环境变量 DDNS_ 前缀加上 key 全大写或者全小写，点转下划线（`${ddns_id}` 或 `${DDNS_ID}`，`${DDNS_LOG_LEVEL}`）
 
+### 配置优先级和字段覆盖关系
+
+如果同一个配置项在多个地方设置，将按照以下优先级规则生效：
+
+- **命令行参数**：优先级最高，会覆盖其他所有设置
+- **JSON配置文件**：介于命令行和环境变量之间，会覆盖环境变量中的设置
+- **环境变量**：优先级最低，当其他方式未设置时使用
+
+**特殊情况**：
+- JSON配置中明确设为`null`的值会覆盖环境变量设置
+- `debug`参数只在命令行中有效，JSON配置文件中的同名设置无效
+- 多值参数（如`ipv4`、`ipv6`等）在命令行中使用方式为重复使用参数，如`--ipv4 domain1 --ipv4 domain2`
+
+各配置方式的详细说明请查看对应文档：[命令行](doc/cli.md)、[JSON配置](doc/json.md)、[环境变量](doc/env.md)
+
 > 📖 **环境变量详细配置**: 查看 [环境变量配置文档](doc/env.md) 了解所有环境变量的详细用法和示例
 
 <details open>
@@ -169,6 +184,7 @@ Dynamic: summary
 - 首次运行会自动生成一个模板配置文件
 - 可以使用 `-c` 使用指定的配置文件（默认读取当前目录的 config.json）
 - 推荐使用 vscode 等支持 JsonSchema 的编辑器编辑配置文件
+- 查看 [JSON配置文件详细文档](doc/json.md) 了解完整的配置选项和示例
 
 ```bash
 ddns -c path/to/config.json
@@ -189,9 +205,9 @@ python run.py -c /path/to/config.json
 | index6   | string\|int\|array |    No    | `"default"` |   ipv6 获取方式   | 可设置 `网卡`、`内网`、`公网`、`正则` 等方式                                                                |
 |  ttl     |       number       |    No    |   `null`    | DNS 解析 TTL 时间 | 不设置采用 DNS 默认策略                                                                                     |
 |  proxy   |       string\|array       |    No    |     无      | http 代理 `;` 分割 | 多代理逐个尝试直到成功，`DIRECT` 为直连                                                                     |
-| ~~debug~~|        bool        |    No    |   `false`   |   是否开启调试    | v4 中弃用，请改用 log.level=DEBUG                                                                           |
+|  debug  |        bool        |    No    |   `false`   |   是否开启调试    | 等同于设置 log.level=DEBUG，仅命令行参数`--debug`有效                                                  |
 |  cache   |    string\|bool    |    No    |   `true`    |   是否缓存记录    | 正常情况打开避免频繁更新，默认位置为临时目录下 `ddns.cache`，也可以指定一个具体路径                          |
-|  log     | {"level":string,"file":string} | No | `null` | 日志配置（可选） | 日志配置，日志级别和路径（默认命令行），例如：`{ "level": "DEBUG", "file": "dns.log" }`                    |
+|  log     | object | No | `null` | 日志配置（可选） | 日志配置对象，支持`level`、`file`、`format`、`datefmt`参数                   |
 
 #### index4 和 index6 参数说明
 
@@ -237,7 +253,9 @@ python run.py -c /path/to/config.json
   "proxy": "127.0.0.1:1080;DIRECT",
   "log": {
     "level": "DEBUG",
-    "file": "dns.log"
+    "file": "dns.log",
+    "format": "%(asctime)s %(levelname)s [%(module)s]: %(message)s",
+    "datefmt": "%Y-%m-%dT%H:%M:%S"
   }
 }
 ```

{ddns-4.0.0b5 → ddns-4.0.0b7}/README.md

@@ -19,9 +19,9 @@
   - [二进制文件](https://github.com/NewFuture/DDNS/releases/latest) ![cross platform](https://img.shields.io/badge/system-windows_%7C%20linux_%7C%20mac-success.svg?style=social)
   
 - 配置方式:
-  - [命令行参数](#详细配置)
-  - [JSON 配置文件](#详细配置)
-  - [环境变量配置](doc/env.md) 📖
+  - [命令行参数](doc/cli.md)
+  - [JSON 配置文件](doc/json.md)
+  - [环境变量配置](doc/env.md)
 
 - 域名支持:
   - 多个域名支持
@@ -114,12 +114,27 @@
 
 ## 详细配置
 
-所有字段可通过三种方式进行配置
+所有字段可通过三种方式进行配置，优先级为：**命令行参数 > JSON配置文件 > 环境变量**
 
-1. 命令行参数 `ddns --key=value`（`ddns -h` 查看详情），优先级最高
-2. JSON 配置文件（值为 null 认为是有效值，会覆盖环境变量的设置，如果没有对应的 key 则会尝试使用环境变量）
+1. [命令行参数](doc/cli.md) `ddns --key=value`（`ddns -h` 查看详情），优先级最高
+2. [JSON 配置文件](doc/json.md)（值为 null 认为是有效值，会覆盖环境变量的设置，如果没有对应的 key 则会尝试使用环境变量）
 3. 环境变量 DDNS_ 前缀加上 key 全大写或者全小写，点转下划线（`${ddns_id}` 或 `${DDNS_ID}`，`${DDNS_LOG_LEVEL}`）
 
+### 配置优先级和字段覆盖关系
+
+如果同一个配置项在多个地方设置，将按照以下优先级规则生效：
+
+- **命令行参数**：优先级最高，会覆盖其他所有设置
+- **JSON配置文件**：介于命令行和环境变量之间，会覆盖环境变量中的设置
+- **环境变量**：优先级最低，当其他方式未设置时使用
+
+**特殊情况**：
+- JSON配置中明确设为`null`的值会覆盖环境变量设置
+- `debug`参数只在命令行中有效，JSON配置文件中的同名设置无效
+- 多值参数（如`ipv4`、`ipv6`等）在命令行中使用方式为重复使用参数，如`--ipv4 domain1 --ipv4 domain2`
+
+各配置方式的详细说明请查看对应文档：[命令行](doc/cli.md)、[JSON配置](doc/json.md)、[环境变量](doc/env.md)
+
 > 📖 **环境变量详细配置**: 查看 [环境变量配置文档](doc/env.md) 了解所有环境变量的详细用法和示例
 
 <details open>
@@ -128,6 +143,7 @@
 - 首次运行会自动生成一个模板配置文件
 - 可以使用 `-c` 使用指定的配置文件（默认读取当前目录的 config.json）
 - 推荐使用 vscode 等支持 JsonSchema 的编辑器编辑配置文件
+- 查看 [JSON配置文件详细文档](doc/json.md) 了解完整的配置选项和示例
 
 ```bash
 ddns -c path/to/config.json
@@ -148,9 +164,9 @@ python run.py -c /path/to/config.json
 | index6   | string\|int\|array |    No    | `"default"` |   ipv6 获取方式   | 可设置 `网卡`、`内网`、`公网`、`正则` 等方式                                                                |
 |  ttl     |       number       |    No    |   `null`    | DNS 解析 TTL 时间 | 不设置采用 DNS 默认策略                                                                                     |
 |  proxy   |       string\|array       |    No    |     无      | http 代理 `;` 分割 | 多代理逐个尝试直到成功，`DIRECT` 为直连                                                                     |
-| ~~debug~~|        bool        |    No    |   `false`   |   是否开启调试    | v4 中弃用，请改用 log.level=DEBUG                                                                           |
+|  debug  |        bool        |    No    |   `false`   |   是否开启调试    | 等同于设置 log.level=DEBUG，仅命令行参数`--debug`有效                                                  |
 |  cache   |    string\|bool    |    No    |   `true`    |   是否缓存记录    | 正常情况打开避免频繁更新，默认位置为临时目录下 `ddns.cache`，也可以指定一个具体路径                          |
-|  log     | {"level":string,"file":string} | No | `null` | 日志配置（可选） | 日志配置，日志级别和路径（默认命令行），例如：`{ "level": "DEBUG", "file": "dns.log" }`                    |
+|  log     | object | No | `null` | 日志配置（可选） | 日志配置对象，支持`level`、`file`、`format`、`datefmt`参数                   |
 
 #### index4 和 index6 参数说明
 
@@ -196,7 +212,9 @@ python run.py -c /path/to/config.json
   "proxy": "127.0.0.1:1080;DIRECT",
   "log": {
     "level": "DEBUG",
-    "file": "dns.log"
+    "file": "dns.log",
+    "format": "%(asctime)s %(levelname)s [%(module)s]: %(message)s",
+    "datefmt": "%Y-%m-%dT%H:%M:%S"
   }
 }
 ```

{ddns-4.0.0b5 → ddns-4.0.0b7}/ddns.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: ddns
-Version: 4.0.0b5
-Summary: automatically update DNS records to dynamic local IP [自动更新DNS记录指向本地IP]
+Version: 4.0.0b7
+Summary: automatically update DNS records to my IP [域名自动指向本机IP]
 Home-page: https://ddns.newfuture.cc
 Author: NewFuture
 Author-email: python@newfuture.cc
@@ -60,9 +60,9 @@ Dynamic: summary
   - [二进制文件](https://github.com/NewFuture/DDNS/releases/latest) ![cross platform](https://img.shields.io/badge/system-windows_%7C%20linux_%7C%20mac-success.svg?style=social)
   
 - 配置方式:
-  - [命令行参数](#详细配置)
-  - [JSON 配置文件](#详细配置)
-  - [环境变量配置](doc/env.md) 📖
+  - [命令行参数](doc/cli.md)
+  - [JSON 配置文件](doc/json.md)
+  - [环境变量配置](doc/env.md)
 
 - 域名支持:
   - 多个域名支持
@@ -155,12 +155,27 @@ Dynamic: summary
 
 ## 详细配置
 
-所有字段可通过三种方式进行配置
+所有字段可通过三种方式进行配置，优先级为：**命令行参数 > JSON配置文件 > 环境变量**
 
-1. 命令行参数 `ddns --key=value`（`ddns -h` 查看详情），优先级最高
-2. JSON 配置文件（值为 null 认为是有效值，会覆盖环境变量的设置，如果没有对应的 key 则会尝试使用环境变量）
+1. [命令行参数](doc/cli.md) `ddns --key=value`（`ddns -h` 查看详情），优先级最高
+2. [JSON 配置文件](doc/json.md)（值为 null 认为是有效值，会覆盖环境变量的设置，如果没有对应的 key 则会尝试使用环境变量）
 3. 环境变量 DDNS_ 前缀加上 key 全大写或者全小写，点转下划线（`${ddns_id}` 或 `${DDNS_ID}`，`${DDNS_LOG_LEVEL}`）
 
+### 配置优先级和字段覆盖关系
+
+如果同一个配置项在多个地方设置，将按照以下优先级规则生效：
+
+- **命令行参数**：优先级最高，会覆盖其他所有设置
+- **JSON配置文件**：介于命令行和环境变量之间，会覆盖环境变量中的设置
+- **环境变量**：优先级最低，当其他方式未设置时使用
+
+**特殊情况**：
+- JSON配置中明确设为`null`的值会覆盖环境变量设置
+- `debug`参数只在命令行中有效，JSON配置文件中的同名设置无效
+- 多值参数（如`ipv4`、`ipv6`等）在命令行中使用方式为重复使用参数，如`--ipv4 domain1 --ipv4 domain2`
+
+各配置方式的详细说明请查看对应文档：[命令行](doc/cli.md)、[JSON配置](doc/json.md)、[环境变量](doc/env.md)
+
 > 📖 **环境变量详细配置**: 查看 [环境变量配置文档](doc/env.md) 了解所有环境变量的详细用法和示例
 
 <details open>
@@ -169,6 +184,7 @@ Dynamic: summary
 - 首次运行会自动生成一个模板配置文件
 - 可以使用 `-c` 使用指定的配置文件（默认读取当前目录的 config.json）
 - 推荐使用 vscode 等支持 JsonSchema 的编辑器编辑配置文件
+- 查看 [JSON配置文件详细文档](doc/json.md) 了解完整的配置选项和示例
 
 ```bash
 ddns -c path/to/config.json
@@ -189,9 +205,9 @@ python run.py -c /path/to/config.json
 | index6   | string\|int\|array |    No    | `"default"` |   ipv6 获取方式   | 可设置 `网卡`、`内网`、`公网`、`正则` 等方式                                                                |
 |  ttl     |       number       |    No    |   `null`    | DNS 解析 TTL 时间 | 不设置采用 DNS 默认策略                                                                                     |
 |  proxy   |       string\|array       |    No    |     无      | http 代理 `;` 分割 | 多代理逐个尝试直到成功，`DIRECT` 为直连                                                                     |
-| ~~debug~~|        bool        |    No    |   `false`   |   是否开启调试    | v4 中弃用，请改用 log.level=DEBUG                                                                           |
+|  debug  |        bool        |    No    |   `false`   |   是否开启调试    | 等同于设置 log.level=DEBUG，仅命令行参数`--debug`有效                                                  |
 |  cache   |    string\|bool    |    No    |   `true`    |   是否缓存记录    | 正常情况打开避免频繁更新，默认位置为临时目录下 `ddns.cache`，也可以指定一个具体路径                          |
-|  log     | {"level":string,"file":string} | No | `null` | 日志配置（可选） | 日志配置，日志级别和路径（默认命令行），例如：`{ "level": "DEBUG", "file": "dns.log" }`                    |
+|  log     | object | No | `null` | 日志配置（可选） | 日志配置对象，支持`level`、`file`、`format`、`datefmt`参数                   |
 
 #### index4 和 index6 参数说明
 
@@ -237,7 +253,9 @@ python run.py -c /path/to/config.json
   "proxy": "127.0.0.1:1080;DIRECT",
   "log": {
     "level": "DEBUG",
-    "file": "dns.log"
+    "file": "dns.log",
+    "format": "%(asctime)s %(levelname)s [%(module)s]: %(message)s",
+    "datefmt": "%Y-%m-%dT%H:%M:%S"
   }
 }
 ```

{ddns-4.0.0b5 → ddns-4.0.0b7}/run.py

@@ -6,13 +6,11 @@ DDNS
 @modified: rufengsuixing
 """
 
-# nuitka-project: --product-version=0.0.0
-
 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
+from logging import basicConfig, info, warning, error, debug, DEBUG, NOTSET
 
 import sys
 
@@ -20,8 +18,8 @@ from util import ip
 from util.cache import Cache
 from util.config import init_config, get_config
 
-__version__ = "v4.0.0-beta5@2025-06-12T01:13:18+00:00"  # CI 时会被Tag替换
-__description__ = "automatically update DNS records to dynamic local IP [自动更新DNS记录指向本地IP]"
+__version__ = "v4.0.0-beta7@2025-06-13T14:46:22+00:00"  # CI 时会被Tag替换
+__description__ = "automatically update DNS records to my IP [域名自动指向本机IP]"
 __doc__ = """
 ddns[%s]
 (i) homepage or docs [文档主页]: https://ddns.newfuture.cc/
@@ -29,7 +27,7 @@ ddns[%s]
 Copyright (c) New Future (MIT License)
 """ % (__version__)
 
-environ["DDNS_VERSION"] = "v4.0.0-beta5"
+environ["DDNS_VERSION"] = "v4.0.0-beta7"
 
 
 def is_false(value):
@@ -127,21 +125,28 @@ def main():
     更新
     """
     init_config(__description__, __doc__, __version__)
-    # Dynamicly import the dns module as configuration
-    dns_provider = str(get_config('dns', 'dnspod').lower())
-    dns = getattr(__import__('dns', fromlist=[dns_provider]), dns_provider)
-    dns.Config.ID = get_config('id')
-    dns.Config.TOKEN = get_config('token')
-    dns.Config.TTL = get_config('ttl')
 
+    log_level = get_config('log.level')
+    log_format = get_config('log.format', '%(asctime)s %(levelname)s [%(module)s]: %(message)s')
+    # Override log format in debug mode to include filename and line number for detailed debugging
+    if (log_level == DEBUG or log_level == NOTSET) and not log_format:
+        log_format = '%(asctime)s %(levelname)s [%(filename)s:%(lineno)d]: %(message)s'
     basicConfig(
-        level=get_config('log.level'),
-        format='%(asctime)s [%(levelname)s] %(message)s',
-        datefmt='%m-%d %H:%M:%S',
+        level=log_level,
+        format=log_format,
+        datefmt=get_config('log.datefmt', '%Y-%m-%dT%H:%M:%S'),
         filename=get_config('log.file'),
     )
 
     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 = getattr(__import__('dns', fromlist=[dns_provider]), 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')))
 
@@ -169,9 +174,23 @@ def main():
 
 
 if __name__ == '__main__':
-    encoding = sys.stdout.encoding
-    if encoding is not None and encoding.lower() != 'utf-8' and hasattr(sys.stdout, 'buffer'):
+    encode = sys.stdout.encoding
+    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')
     main()
+
+# Nuitka Project Configuration
+# nuitka-project: --mode=onefile
+# nuitka-project: --output-filename=ddns
+# nuitka-project: --product-name=DDNS
+# nuitka-project: --product-version=0.0.0
+# nuitka-project: --onefile-tempdir-spec="{TEMP}/{PRODUCT}_{VERSION}"
+# nuitka-project: --no-deployment-flag=self-execution
+# nuitka-project: --company-name="New Future"
+# nuitka-project: --copyright=https://ddns.newfuture.cc
+# nuitka-project: --assume-yes-for-downloads
+# nuitka-project: --python-flag=no_site,no_asserts,no_docstrings,isolated,static_hashes
+# nuitka-project: --nofollow-import-to=tkinter,unittest,pydoc,doctest,distutils,setuptools,lib2to3,test,idlelib,lzma
+# nuitka-project: --noinclude-dlls=liblzma.*

{ddns-4.0.0b5 → ddns-4.0.0b7}/util/config.py

@@ -96,12 +96,22 @@ def init_config(description, doc, version):
                         help='https proxy [设置http 代理，多代理逐个尝试直到成功]')
     parser.add_argument('--cache',  type=str2bool, nargs='?',
                         const=True, help='cache flag [启用缓存，可配配置路径或开关]')
+    parser.add_argument('--debug', action='store_true',
+                        help='debug mode [调试模式，等同log.level=DEBUG]')
     parser.add_argument('--log.file', metavar='LOG_FILE',
                         help='log file [日志文件，默认标准输出]')
     parser.add_argument('--log.level', type=log_level,
                         metavar='|'.join(log_levels))
+    parser.add_argument('--log.format', metavar='LOG_FORMAT',
+                        help='log format [日志格式字符串]')
+    parser.add_argument('--log.datefmt', metavar='DATE_FORMAT',
+                        help='date format [日期格式字符串]')
 
     __cli_args = parser.parse_args()
+    if __cli_args.debug:
+        # 如果启用调试模式，则设置日志级别为 DEBUG
+        setattr(__cli_args, 'log.level', log_level('DEBUG'))
+
     is_configfile_required = not get_config("token") and not get_config("id")
     config_file = get_config("config")
     if not config_file:
@@ -141,6 +151,10 @@ def __load_config(config_path):
                     __config['log.level'] = log_level(__config['log']['level'])
                 if 'file' in __config['log']:
                     __config['log.file'] = __config['log']['file']
+                if 'format' in __config['log']:
+                    __config['log.format'] = __config['log']['format']
+                if 'datefmt' in __config['log']:
+                    __config['log.datefmt'] = __config['log']['datefmt']
             elif 'log.level' in __config:
                 __config['log.level'] = log_level(__config['log.level'])
     except Exception as e:
@@ -211,8 +225,7 @@ def generate_config(config_path):
         'ttl': None,
         'proxy': None,
         'log': {
-            'level': 'INFO',
-            'file': None
+            'level': 'INFO'
         }
     }
     try: