simple-channel-log 1.0__tar.gz

simple_channel_log-1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Unnamed great master <gqylpy@outlook.com>.
+
+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.

simple_channel_log-1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.2
+Name: simple-channel-log
+Version: 1.0
+Summary: 轻量高效的日志库，支持多级别日志记录、日志轮转、流水日志追踪及埋点日志功能，深度集成 Flask 和 Requests 框架。
+Author: Unnamed great master
+Author-email: <gqylpy@outlook.com>
+License: MIT
+Project-URL: Source, https://github.com/2018-11-27/simple-channel-log
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Internet :: Log Analysis
+Classifier: Topic :: Text Processing
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.0
+Classifier: Programming Language :: Python :: 3.1
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=2.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gqylpy_log==0.0a1
+Provides-Extra: flask
+Requires-Dist: Flask>=0.10; extra == "flask"
+Provides-Extra: requests
+Requires-Dist: requests>=2.19; extra == "requests"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# simple-channel-log
+
+[![Release](https://img.shields.io/github/release/2018-11-27/simple-channel-log.svg?style=flat-square")](https://github.com/2018-11-27/simple-channel-log/releases/latest)
+[![Python Version](https://img.shields.io/badge/python-2.7+/3.6+-blue.svg)](https://github.com/2018-11-27/simple-channel-log)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/simple-channel-log)](https://pepy.tech/project/simple-channel-log)
+
+轻量高效的日志库，支持多级别日志记录、日志轮转、流水日志追踪及埋点日志功能，深度集成 Flask 和 Requests 框架。
+
+## 主要特性
+
+- 📅 支持按时间轮转日志（天/小时/分钟等）
+- 📊 提供多级别日志记录（DEBUG/INFO/WARNING/ERROR/CRITICAL）
+- 🌐 内置Flask中间件记录请求/响应流水日志（Journallog-in）
+- 📡 集成Requests会话记录外部调用流水日志（Journallog-out）
+- 🔍 智能处理长字符串截断（超过1000字符自动标记）
+- 📁 自动创建分级日志目录结构
+- 💻 支持终端输出与文件存储分离控制
+
+## 安装
+
+```bash
+pip install simple_channel_log
+```
+
+## 快速入门
+
+### 基础配置
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__("<your_appname>", "<your_syscode>", logdir="/app/logs")
+
+# 初始化后可直接调用日志方法，日志将记录到参数 `logdir` 指定的目录中
+log.debug("调试信息", extra_field="value")
+log.info("业务日志", user_id=123)
+log.warning("异常预警", error_code=500)
+log.error("系统错误", stack_trace="...")
+
+# 埋点日志
+log.trace(
+    user_id=123,
+    action="purchase",
+    item_count=2
+)
+```
+
+### Flask 流水日志
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__(..., enable_journallog_in=True)
+```
+
+设置 `enable_journallog_in=True` 表示启用 Flask 流水日志，将自动记录每个接口的调用信息。
+
+### Requests 外部调用追踪
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__(..., enable_journallog_out=True)
+```
+
+设置 `enable_journallog_out=True` 表示启用 Requests 外部调用追踪，将自动记录每个请求的调用信息。
+
+## 详细配置
+
+### 初始化参数
+
+| 参数名                   | 类型   | 默认值      | 说明                            |
+|-----------------------|------|----------|-------------------------------|
+| appname               | str  | 必填       | 应用名称，建议与CI配置一致                |
+| syscode               | str  | 必填       | 系统编码（大写）                      |
+| logdir                | str  | 系统相关默认路径 | 日志存储根目录                       |
+| when                  | str  | 'D'      | 轮转周期：W(周)/D(天)/H(时)/M(分)/S(秒) |
+| interval              | int  | 1        | 轮转频率                          |
+| backup_count          | int  | 7        | 历史日志保留数量（0=永久）                |
+| output_to_terminal    | bool | False    | 启用后日志将同时输出到控制台                |
+| enable_journallog_in  | bool | False    | 启用Flask请求流水日志                 |
+| enable_journallog_out | bool | False    | 启用Requests外部调用日志              |

simple_channel_log-1.0/README.md

@@ -0,0 +1,89 @@
+# simple-channel-log
+
+[![Release](https://img.shields.io/github/release/2018-11-27/simple-channel-log.svg?style=flat-square")](https://github.com/2018-11-27/simple-channel-log/releases/latest)
+[![Python Version](https://img.shields.io/badge/python-2.7+/3.6+-blue.svg)](https://github.com/2018-11-27/simple-channel-log)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/simple-channel-log)](https://pepy.tech/project/simple-channel-log)
+
+轻量高效的日志库，支持多级别日志记录、日志轮转、流水日志追踪及埋点日志功能，深度集成 Flask 和 Requests 框架。
+
+## 主要特性
+
+- 📅 支持按时间轮转日志（天/小时/分钟等）
+- 📊 提供多级别日志记录（DEBUG/INFO/WARNING/ERROR/CRITICAL）
+- 🌐 内置Flask中间件记录请求/响应流水日志（Journallog-in）
+- 📡 集成Requests会话记录外部调用流水日志（Journallog-out）
+- 🔍 智能处理长字符串截断（超过1000字符自动标记）
+- 📁 自动创建分级日志目录结构
+- 💻 支持终端输出与文件存储分离控制
+
+## 安装
+
+```bash
+pip install simple_channel_log
+```
+
+## 快速入门
+
+### 基础配置
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__("<your_appname>", "<your_syscode>", logdir="/app/logs")
+
+# 初始化后可直接调用日志方法，日志将记录到参数 `logdir` 指定的目录中
+log.debug("调试信息", extra_field="value")
+log.info("业务日志", user_id=123)
+log.warning("异常预警", error_code=500)
+log.error("系统错误", stack_trace="...")
+
+# 埋点日志
+log.trace(
+    user_id=123,
+    action="purchase",
+    item_count=2
+)
+```
+
+### Flask 流水日志
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__(..., enable_journallog_in=True)
+```
+
+设置 `enable_journallog_in=True` 表示启用 Flask 流水日志，将自动记录每个接口的调用信息。
+
+### Requests 外部调用追踪
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__(..., enable_journallog_out=True)
+```
+
+设置 `enable_journallog_out=True` 表示启用 Requests 外部调用追踪，将自动记录每个请求的调用信息。
+
+## 详细配置
+
+### 初始化参数
+
+| 参数名                   | 类型   | 默认值      | 说明                            |
+|-----------------------|------|----------|-------------------------------|
+| appname               | str  | 必填       | 应用名称，建议与CI配置一致                |
+| syscode               | str  | 必填       | 系统编码（大写）                      |
+| logdir                | str  | 系统相关默认路径 | 日志存储根目录                       |
+| when                  | str  | 'D'      | 轮转周期：W(周)/D(天)/H(时)/M(分)/S(秒) |
+| interval              | int  | 1        | 轮转频率                          |
+| backup_count          | int  | 7        | 历史日志保留数量（0=永久）                |
+| output_to_terminal    | bool | False    | 启用后日志将同时输出到控制台                |
+| enable_journallog_in  | bool | False    | 启用Flask请求流水日志                 |
+| enable_journallog_out | bool | False    | 启用Requests外部调用日志              |

simple_channel_log-1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

simple_channel_log-1.0/setup.py

@@ -0,0 +1,58 @@
+# coding:utf-8
+import sys
+import codecs
+import setuptools
+
+if sys.version_info.major < 3:
+    open = codecs.open
+
+setuptools.setup(
+    name='simple-channel-log',
+    version='1.0',
+    author='Unnamed great master',
+    author_email='<gqylpy@outlook.com>',
+    license='MIT',
+    project_urls={
+        'Source': 'https://github.com/2018-11-27/simple-channel-log'
+    },
+    description='''
+        轻量高效的日志库，支持多级别日志记录、日志轮转、流水日志追踪及埋点日志功能，深度集成
+        Flask 和 Requests 框架。
+    '''.strip().replace('\n       ', ''),
+    long_description=open('README.md', encoding='utf8').read(),
+    long_description_content_type='text/markdown',
+    packages=['simple_channel_log'],
+    python_requires='>=2.7',
+    install_requires=['gqylpy_log==0.0a1'],
+    extras_require={
+        'flask': ['Flask>=0.10'],
+        'requests': ['requests>=2.19']
+    },
+    classifiers=[
+        'Development Status :: 3 - Alpha',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: Apache Software License',
+        'Natural Language :: Chinese (Simplified)',
+        'Natural Language :: English',
+        'Operating System :: OS Independent',
+        'Topic :: Software Development :: Libraries :: Python Modules',
+        'Topic :: Artistic Software',
+        'Topic :: Internet :: Log Analysis',
+        'Topic :: Text Processing',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 3.0',
+        'Programming Language :: Python :: 3.1',
+        'Programming Language :: Python :: 3.2',
+        'Programming Language :: Python :: 3.3',
+        'Programming Language :: Python :: 3.4',
+        'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
+        'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13'
+    ]
+)

simple_channel_log-1.0/simple_channel_log/__init__.py

@@ -0,0 +1,71 @@
+# coding:utf-8
+
+
+def __init__(
+        appname,                     # type: str
+        syscode,                     # type: str
+        logdir               =None,  # type: str
+        when                 =None,  # type: str
+        interval             =None,  # type: int
+        backup_count         =None,  # type: int
+        output_to_terminal   =None,  # type: bool
+        enable_journallog_in =None,  # type: bool
+        enable_journallog_out=None   # type: bool
+):
+    """
+    初始化日志配置。
+
+    @param appname:
+        你的应用名称，通常与 GitLab CI 文件中的 APPNAME 字段一致。
+    @param syscode:
+        你的应用分配的系统编码（大写），应与 GitLab CI 文件中的 SVCCODE 字段一致。
+    @param logdir:
+        指定日志目录，默认为 "/app/logs/<syscode>_<appname>"（如果你的系统是 Windows
+        则为 "C:\\BllLogs\\<syscode>_<appname>"）。
+    @param when:
+        控制日志轮转周期，默认为 "D"。支持按天/小时/分钟等单位滚动。可选值有：W:周, D:天,
+        H:小时, M:分钟, S:秒, 等等。
+    @param interval:
+        日志轮转频率，默认为 1 。同参数 `when` 一起使用（如：`when="D"` 且
+        `interval=1` 表示每天滚动一次）。
+    @param backup_count:
+        日志保留策略，控制最大历史版本数量，默认为 7。设为 0 则永久保留。
+    @param output_to_terminal:
+        设为 True 日志将同时输出到终端，默认为 False。流水日志和埋点日志除外。
+    @param enable_journallog_in:
+        设为 True 表示启用内部流水日志，默认为 False。目前仅支持 Flask 框架。
+    @param enable_journallog_out:
+        设为 True 表示启用外部流水日志，默认为 False。目前仅支持 requests 框架。
+    """
+
+
+def debug    (msg, *args, **extra): pass
+def info     (msg, *args, **extra): pass
+def warning  (msg, *args, **extra): pass
+def warn     (msg, *args, **extra): pass
+def error    (msg, *args, **extra): pass
+def exception(msg, *args, **extra): pass
+def critical (msg, *args, **extra): pass
+def fatal    (msg, *args, **extra): pass
+
+def trace(**extra): pass  # 埋点日志
+
+
+class _xe6_xad_x8c_xe7_x90_xaa_xe6_x80_xa1_xe7_x8e_xb2_xe8_x90_x8d_xe4_xba_x91:
+    import sys
+
+    ipath = __name__ + '.i ' + __name__
+    __import__(ipath)
+
+    ipack = sys.modules[__name__]
+    icode = globals()['i ' + __name__]
+
+    for iname in globals():
+        if iname[0] != '_':
+            ifunc = getattr(icode, iname, None)
+            if ifunc:
+                ifunc.__module__ = __package__
+                ifunc.__doc__ = getattr(ipack, iname).__doc__
+                setattr(ipack, iname, ifunc)
+
+    ipack.__init__ = icode.__init__

simple_channel_log-1.0/simple_channel_log/i simple_channel_log.py

@@ -0,0 +1,555 @@
+# coding:utf-8
+import os
+import re
+import sys
+import time
+import uuid
+import json as jsonx
+import socket
+import inspect
+import warnings
+import functools
+import threading
+
+from datetime import datetime
+
+if os.path.basename(sys.argv[0]) != 'setup.py':
+    import gqylpy_log as glog
+
+try:
+    from flask import Flask
+except ImportError:
+    Flask = None
+else:
+    from flask import g
+    from flask import request
+    from flask import current_app
+    from flask import has_request_context
+
+    def __new__(cls, *a, **kw):
+        app = super(Flask, cls).__new__(cls)
+        cls.__apps__.append(app)
+        return app
+
+    if sys.version_info.major < 3:
+        __new__ = staticmethod(__new__)
+
+    Flask.__apps__, Flask.__new__ = [], __new__
+
+try:
+    import requests
+except ImportError:
+    requests = None
+
+if sys.version_info.major < 3:
+    from urlparse import urlparse
+    from urlparse import parse_qs
+else:
+    from urllib.parse import urlparse
+    from urllib.parse import parse_qs
+
+    unicode = str
+
+co_qualname = 'co_qualname' if sys.version_info >= (3, 11) else 'co_name'
+
+that = sys.modules[__package__]
+this = sys.modules[__name__]
+
+unique = object()
+
+
+def __init__(
+        appname,
+        syscode,
+        logdir=r'C:\BllLogs' if sys.platform == 'win32' else '/app/logs',
+        when='D',
+        interval=1,
+        backup_count=7,
+        stream=unique,
+        output_to_terminal=None,
+        enable_journallog_in=False,
+        enable_journallog_out=False
+):
+    if hasattr(this, 'appname'):
+        raise RuntimeError('repeat initialization.')
+
+    if re.match(r'[A-Za-z]\d{9}$', syscode) is None:
+        raise ValueError('parameter syscode "%s" is illegal' % syscode)
+
+    prefix = re.match(r'[a-zA-Z]\d{9}[_-]', appname)
+    if prefix is None:
+        appname = syscode.lower() + '_' + appname
+    elif prefix.group()[:-1].upper() != syscode.upper():
+        raise ValueError('parameter appname "%s" is illegal' % syscode)
+
+    if stream is not unique:
+        warnings.warn(
+            'parameter "stream" will be deprecated soon, replaced to '
+            '"output_to_terminal".', category=DeprecationWarning,
+            stacklevel=2
+        )
+        if output_to_terminal is None:
+            output_to_terminal = stream
+
+    that.appname = this.appname = appname = \
+        appname[0].lower() + appname[1:10] + '_' + appname[11:]
+    that.syscode = this.syscode = syscode.upper()
+    this.output_to_terminal = output_to_terminal
+
+    handlers = [{
+        'name': 'TimedRotatingFileHandler',
+        'level': 'DEBUG',
+        'filename': '%s/%s/debug/%s_code-debug.log' %
+                    (logdir, appname, appname),
+        'encoding': 'UTF-8',
+        'when': when,
+        'interval': interval,
+        'backupCount': backup_count,
+        'options': {'onlyRecordCurrentLevel': True}
+    }]
+
+    for level in 'info', 'warning', 'error', 'critical':
+        handlers.append({
+            'name': 'TimedRotatingFileHandler',
+            'level': level.upper(),
+            'filename': '%s/%s/%s_code-%s.log' %
+                        (logdir, appname, appname, level),
+            'encoding': 'UTF-8',
+            'when': when,
+            'interval': interval,
+            'backupCount': backup_count,
+            'options': {'onlyRecordCurrentLevel': True}
+        })
+
+    glog.__init__('code', handlers=handlers, gname='code')
+
+    if output_to_terminal:
+        glog.__init__(
+            'stream',
+            formatter={
+                'fmt': '[%(asctime)s] [%(levelname)s] %(message)s',
+                'datefmt': '%Y-%m-%d %H:%M:%S'
+            },
+            handlers=[{'name': 'StreamHandler'}],
+            gname='stream'
+        )
+
+    enable_journallog = False
+
+    if enable_journallog_in and Flask is not None:
+        enable_journallog = True
+        thread = threading.Thread(target=register_flask_middleware)
+        thread.daemon = True
+        thread.start()
+
+    if enable_journallog_out and requests is not None:
+        enable_journallog = True
+        requests.Session.request = journallog_out(requests.Session.request)
+
+    if enable_journallog:
+        glog.__init__(
+            'info',
+            handlers=[{
+                'name': 'TimedRotatingFileHandler',
+                'level': 'INFO',
+                'filename': '%s/%s/%s_info-info.log' %
+                            (logdir, appname, appname),
+                'encoding': 'UTF-8',
+                'when': when,
+                'interval': interval,
+                'backupCount': backup_count,
+            }],
+            gname='info_'
+        )
+
+    glog.__init__(
+        'trace',
+        handlers=[{
+            'name': 'TimedRotatingFileHandler',
+            'level': 'DEBUG',
+            'filename': '%s/%s/trace/%s_trace-trace.log' %
+                        (logdir, appname, appname),
+            'encoding': 'UTF-8',
+            'when': when,
+            'interval': interval,
+            'backupCount': backup_count,
+        }],
+        gname='trace'
+    )
+
+
+def register_flask_middleware():
+    start = time.time()
+    while not Flask.__apps__ and time.time() - start < 300:
+        time.sleep(.02)
+
+    for app in Flask.__apps__:
+        app.before_request(journallog_in_before)
+        app.after_request(journallog_in)
+
+
+def logger(msg, *args, **extra):
+    args = tuple(OmitLongString(v) for v in args)
+    extra = OmitLongString(extra)
+
+    if sys.version_info.major < 3 and isinstance(msg, str):
+        msg = msg.decode('utf8')
+
+    if isinstance(msg, unicode):
+        msg = (msg % args)[:1000]
+    elif isinstance(msg, (dict, list, tuple)):
+        msg = OmitLongString(msg)
+
+    transaction_id = g.transaction_id \
+        if Flask is not None and has_request_context() else uuid.uuid4().hex
+
+    f_back = inspect.currentframe().f_back
+    level = f_back.f_code.co_name
+    f_back = f_back.f_back
+
+    data = {
+        'app_name': this.appname + '_code',
+        'level': level.upper(),
+        'log_time': datetime.now().strftime('%Y-%m-%d %H:%M:%S.%f')[:-3],
+        'logger': __package__,
+        'thread': threading.current_thread().ident,
+        'code_message': msg,
+        'transaction_id': transaction_id,
+        'method_code': None,
+        'method_name': getattr(f_back.f_code, co_qualname),
+        'error_code': None,
+        'tag': None,
+        'host_name': socket.gethostname(),
+        'filename': f_back.f_code.co_filename,
+        'line': f_back.f_lineno
+    }
+
+    for k, v in extra.items():
+        if data.get(k) is None:
+            data[k] = v
+
+    getattr(glog, level)(jsonx.dumps(data, ensure_ascii=False), gname='code')
+
+    if this.output_to_terminal:
+        getattr(glog, level)(msg, gname='stream')
+
+
+def debug(msg, *args, **extra):
+    logger(msg, *args, **extra)
+
+
+def info(msg, *args, **extra):
+    logger(msg, *args, **extra)
+
+
+def warning(msg, *args, **extra):
+    logger(msg, *args, **extra)
+
+
+warn = warning
+
+
+def error(msg, *args, **extra):
+    logger(msg, *args, **extra)
+
+
+exception = error
+
+
+def critical(msg, *args, **extra):
+    logger(msg, *args, **extra)
+
+
+fatal = critical
+
+
+def trace(**extra):
+    extra = OmitLongString(extra)
+    extra.update({'app_name': this.appname + '_trace', 'level': 'TRACE'})
+    glog.debug(jsonx.dumps(extra, ensure_ascii=False), gname='trace')
+
+
+def journallog_in_before():
+    if request.path == '/healthcheck':
+        return
+
+    g.request_time = datetime.now()
+
+    if request.args:
+        request_data = request.args.to_dict()
+    elif request.form:
+        request_data = request.form.to_dict()
+    else:
+        request_body = request.data
+        try:
+            request_data = jsonx.loads(request_body) if request_body else None
+        except ValueError:
+            request_data = None
+
+    g.request_data = request_data
+
+    g.transaction_id = (
+        FindTransactionID(dict(request.headers)).result or
+        FindTransactionID(request_data).result or
+        uuid.uuid4().hex
+    )
+
+
+def journallog_in(response):
+    if request.path == '/healthcheck':
+        return response
+
+    parsed_url = urlparse(request.url)
+    address = parsed_url.scheme + '://' + parsed_url.netloc + parsed_url.path
+
+    view_func = current_app.view_functions.get(request.endpoint)
+    method_name = view_func.__name__ if view_func else None
+
+    try:
+        response_data = jsonx.loads(response.get_data())
+    except ValueError:
+        response_data = response_code = order_id = \
+            province_code = city_code = \
+            account_type = account_num = \
+            response_account_type = response_account_num = None
+    else:
+        if isinstance(response_data, dict):
+            head = response_data.get('head')
+            x = head if isinstance(head, dict) else response_data
+            response_code = x.get('code')
+            order_id = x.get('order_id')
+            province_code = x.get('province_code')
+            city_code = x.get('city_code')
+            account_type = x.get('account_type')
+            account_num = x.get('account_num')
+            response_account_type = x.get('response_account_type')
+            response_account_num = x.get('response_account_num')
+        else:
+            response_code = order_id = \
+                province_code = city_code = \
+                account_type = account_num = \
+                response_account_type = response_account_num = None
+
+    response_time = datetime.now()
+    response_time_str = response_time.strftime('%Y-%m-%d %H:%M:%S.%f')[:-3]
+
+    total_time = round((response_time - g.request_time).total_seconds(), 3)
+
+    glog.info(jsonx.dumps({
+        'app_name': this.appname + '_info',
+        'level': 'INFO',
+        'log_time': response_time_str,
+        'logger': __package__,
+        'thread': threading.current_thread().ident,
+        'transaction_id': g.transaction_id,
+        'dialog_type': 'in',
+        'address': address,
+        'fcode': request.headers.get('User-Agent'),
+        'tcode': this.syscode,
+        'method_code': None,
+        'method_name': method_name,
+        'http_method': request.method,
+        'request_time': g.request_time.strftime('%Y-%m-%d %H:%M:%S.%f')[:-3],
+        'request_headers': dict(request.headers),
+        'request_payload': OmitLongString(g.request_data),
+        'response_time': response_time_str,
+        'response_headers': dict(response.headers),
+        'response_payload': OmitLongString(response_data),
+        'response_code': response_code,
+        'response_remark': None,
+        'http_status_code': response.status_code,
+        'order_id': order_id,
+        'province_code': province_code,
+        'city_code': city_code,
+        'total_time': total_time,
+        'error_code': response_code,
+        'request_ip': request.remote_addr,
+        'host_ip': parsed_url.hostname,
+        'host_name': socket.gethostname(),
+        'account_type': account_type,
+        'account_num': account_num,
+        'response_account_type': response_account_type,
+        'response_account_num': response_account_num,
+        'user': None,
+        'tag': None,
+        'service_line': None
+    }, ensure_ascii=False), gname='info_')
+
+    return response
+
+
+def journallog_out(func):
+
+    @functools.wraps(func)
+    def inner(
+            self, method, url,
+            headers=None, params=None, data=None, json=None,
+            **kw
+    ):
+        if headers is None:
+            headers = {'User-Agent': this.syscode}
+        else:
+            headers['User-Agent'] = this.syscode
+
+        f_back = inspect.currentframe().f_back.f_back
+        if f_back.f_back is not None:
+            f_back = f_back.f_back
+        method_name = getattr(f_back.f_code, co_qualname)
+
+        parse_url = urlparse(url)
+        address = parse_url.scheme + '://' + parse_url.netloc + parse_url.path
+        query_string = {k: v[0] for k, v in parse_qs(parse_url.query).items()}
+
+        if params is not None:
+            params.update(query_string)
+            request_data = params
+        elif query_string:
+            request_data = query_string
+        elif data:
+            request_data = data
+            if isinstance(request_data, (str, unicode)):
+                try:
+                    request_data = jsonx.loads(request_data)
+                except ValueError:
+                    pass
+        elif json:
+            request_data = json
+        else:
+            request_data = None
+
+        if Flask is not None and has_request_context():
+            transaction_id = g.transaction_id
+        else:
+            transaction_id = (
+                FindTransactionID(headers).result or
+                FindTransactionID(request_data).result or
+                uuid.uuid4().hex
+            )
+
+        for name in headers.copy():
+            namex = name.replace('-', '').replace('_', '').lower()
+            if namex == 'transactionid':
+                del headers[name]
+        headers['Transaction-ID'] = transaction_id
+
+        request_time = datetime.now()
+        response = func(
+            self, method, url,
+            headers=headers, params=params, data=data, json=json,
+            **kw
+        )
+        response_time = datetime.now()
+        response_time_str = response_time.strftime('%Y-%m-%d %H:%M:%S.%f')[:-3]
+
+        try:
+            response_data = response.json()
+        except ValueError:
+            response_data = response_code = order_id = \
+                province_code = city_code = \
+                account_type = account_num = \
+                response_account_type = response_account_num = None
+        else:
+            if isinstance(response_data, dict):
+                head = response_data.get('head')
+                x = head if isinstance(head, dict) else response_data
+                response_code = x.get('code')
+                order_id = x.get('order_id')
+                province_code = x.get('province_code')
+                city_code = x.get('city_code')
+                account_type = x.get('account_type')
+                account_num = x.get('account_num')
+                response_account_type = x.get('response_account_type')
+                response_account_num = x.get('response_account_num')
+            else:
+                response_code = order_id = \
+                    province_code = city_code = \
+                    account_type = account_num = \
+                    response_account_type = response_account_num = None
+
+        total_time = round((response_time - request_time).total_seconds(), 3)
+
+        glog.info(jsonx.dumps({
+            'app_name': this.appname + '_info',
+            'level': 'INFO',
+            'log_time': response_time_str,
+            'logger': __package__,
+            'thread': threading.current_thread().ident,
+            'transaction_id': transaction_id,
+            'dialog_type': 'out',
+            'address': address,
+            'fcode': this.syscode,
+            'tcode': this.syscode,
+            'method_code': None,
+            'method_name': method_name,
+            'http_method': response.request.method,
+            'request_time': request_time.strftime('%Y-%m-%d %H:%M:%S.%f')[:-3],
+            'request_headers': dict(response.request.headers),
+            'request_payload': OmitLongString(request_data),
+            'response_time': response_time_str,
+            'response_headers': dict(response.headers),
+            'response_payload': OmitLongString(response_data),
+            'response_code': response_code,
+            'response_remark': None,
+            'http_status_code': response.status_code,
+            'order_id': order_id,
+            'province_code': province_code,
+            'city_code': city_code,
+            'total_time': total_time,
+            'error_code': response_code,
+            'request_ip': parse_url.hostname,
+            'host_ip': socket.gethostbyname(socket.gethostname()),
+            'host_name': socket.gethostname(),
+            'account_type': account_type,
+            'account_num': account_num,
+            'response_account_type': response_account_type,
+            'response_account_num': response_account_num,
+            'user': None,
+            'tag': None,
+            'service_line': None
+        }, ensure_ascii=False), gname='info_')
+
+        return response
+
+    return inner
+
+
+class OmitLongString(dict):
+
+    def __init__(self, data):
+        for name, value in data.items():
+            dict.__setitem__(self, name, OmitLongString(value))
+
+    def __new__(cls, data):
+        if isinstance(data, dict):
+            return dict.__new__(cls)
+
+        if isinstance(data, (list, tuple)):
+            return data.__class__(cls(v) for v in data)
+
+        if sys.version_info.major < 3 and isinstance(data, str):
+            data = data.decode('utf8')
+
+        if isinstance(data, (unicode, str)) and len(data) > 1000:
+            data = '<Ellipsis>'
+
+        return data
+
+
+class FindTransactionID(dict):
+    result = None
+
+    def __init__(self, data, root=None):
+        if root is None:
+            root = self
+        for k, v in data.items():
+            if k.replace('-', '').replace('_', '').lower() == 'transactionid':
+                root.result = data[k]
+                break
+            dict.__setitem__(self, k, FindTransactionID(v, root=root))
+
+    def __new__(cls, data, root=None):
+        if isinstance(data, dict):
+            return dict.__new__(cls)
+        if isinstance(data, (list, tuple)):
+            return data.__class__(cls(v) for v in data)
+        return cls

simple_channel_log-1.0/simple_channel_log.egg-info/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.2
+Name: simple-channel-log
+Version: 1.0
+Summary: 轻量高效的日志库，支持多级别日志记录、日志轮转、流水日志追踪及埋点日志功能，深度集成 Flask 和 Requests 框架。
+Author: Unnamed great master
+Author-email: <gqylpy@outlook.com>
+License: MIT
+Project-URL: Source, https://github.com/2018-11-27/simple-channel-log
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Internet :: Log Analysis
+Classifier: Topic :: Text Processing
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.0
+Classifier: Programming Language :: Python :: 3.1
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=2.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gqylpy_log==0.0a1
+Provides-Extra: flask
+Requires-Dist: Flask>=0.10; extra == "flask"
+Provides-Extra: requests
+Requires-Dist: requests>=2.19; extra == "requests"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# simple-channel-log
+
+[![Release](https://img.shields.io/github/release/2018-11-27/simple-channel-log.svg?style=flat-square")](https://github.com/2018-11-27/simple-channel-log/releases/latest)
+[![Python Version](https://img.shields.io/badge/python-2.7+/3.6+-blue.svg)](https://github.com/2018-11-27/simple-channel-log)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/simple-channel-log)](https://pepy.tech/project/simple-channel-log)
+
+轻量高效的日志库，支持多级别日志记录、日志轮转、流水日志追踪及埋点日志功能，深度集成 Flask 和 Requests 框架。
+
+## 主要特性
+
+- 📅 支持按时间轮转日志（天/小时/分钟等）
+- 📊 提供多级别日志记录（DEBUG/INFO/WARNING/ERROR/CRITICAL）
+- 🌐 内置Flask中间件记录请求/响应流水日志（Journallog-in）
+- 📡 集成Requests会话记录外部调用流水日志（Journallog-out）
+- 🔍 智能处理长字符串截断（超过1000字符自动标记）
+- 📁 自动创建分级日志目录结构
+- 💻 支持终端输出与文件存储分离控制
+
+## 安装
+
+```bash
+pip install simple_channel_log
+```
+
+## 快速入门
+
+### 基础配置
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__("<your_appname>", "<your_syscode>", logdir="/app/logs")
+
+# 初始化后可直接调用日志方法，日志将记录到参数 `logdir` 指定的目录中
+log.debug("调试信息", extra_field="value")
+log.info("业务日志", user_id=123)
+log.warning("异常预警", error_code=500)
+log.error("系统错误", stack_trace="...")
+
+# 埋点日志
+log.trace(
+    user_id=123,
+    action="purchase",
+    item_count=2
+)
+```
+
+### Flask 流水日志
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__(..., enable_journallog_in=True)
+```
+
+设置 `enable_journallog_in=True` 表示启用 Flask 流水日志，将自动记录每个接口的调用信息。
+
+### Requests 外部调用追踪
+
+```python
+# coding:utf-8
+import simple_channel_log as log
+
+# 初始化日志配置
+log.__init__(..., enable_journallog_out=True)
+```
+
+设置 `enable_journallog_out=True` 表示启用 Requests 外部调用追踪，将自动记录每个请求的调用信息。
+
+## 详细配置
+
+### 初始化参数
+
+| 参数名                   | 类型   | 默认值      | 说明                            |
+|-----------------------|------|----------|-------------------------------|
+| appname               | str  | 必填       | 应用名称，建议与CI配置一致                |
+| syscode               | str  | 必填       | 系统编码（大写）                      |
+| logdir                | str  | 系统相关默认路径 | 日志存储根目录                       |
+| when                  | str  | 'D'      | 轮转周期：W(周)/D(天)/H(时)/M(分)/S(秒) |
+| interval              | int  | 1        | 轮转频率                          |
+| backup_count          | int  | 7        | 历史日志保留数量（0=永久）                |
+| output_to_terminal    | bool | False    | 启用后日志将同时输出到控制台                |
+| enable_journallog_in  | bool | False    | 启用Flask请求流水日志                 |
+| enable_journallog_out | bool | False    | 启用Requests外部调用日志              |

simple_channel_log-1.0/simple_channel_log.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+simple_channel_log/__init__.py
+simple_channel_log/i simple_channel_log.py
+simple_channel_log.egg-info/PKG-INFO
+simple_channel_log.egg-info/SOURCES.txt
+simple_channel_log.egg-info/dependency_links.txt
+simple_channel_log.egg-info/requires.txt
+simple_channel_log.egg-info/top_level.txt

simple_channel_log-1.0/simple_channel_log.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

simple_channel_log-1.0/simple_channel_log.egg-info/requires.txt

@@ -0,0 +1,7 @@
+gqylpy_log==0.0a1
+
+[flask]
+Flask>=0.10
+
+[requests]
+requests>=2.19

simple_channel_log-1.0/simple_channel_log.egg-info/top_level.txt

@@ -0,0 +1 @@
+simple_channel_log