## 介绍
**特点**
- py-logiliteal 是一个简单的、现代化的、具有色彩的日志记录器
- py-logiliteal 提供了简单的配置、格式化、颜色、前缀等功能
- py-logiliteal 提供了简单的日志等级, 可以自定义日志等级, 日志格式, 日志颜色, 日志前缀等
**允许嵌入**
py-logiliteal 允许嵌入到其他项目中, 并根据需要自定义日志记录器
同时也支持pip安装
```bash
pip install logiliteal
```
**支持高可扩展的样式**
- 支持使用HEX十六进制颜色代码`<#ffffff>text</>`渲染颜色
- 支持使用占位符`{placeholder}`渲染变量(可手动扩展)
- 支持部分Html或Markdown语法(如`<b>text</b>`)
- 支持自定义日志格式和日志颜色
Html语法支持:
- `<b>text</b>` 加粗
- `<i>text</i>` 斜体
- `<u>text</u>` 下划线
- `<s>text</s>` 删除线
- `<c>` 清除颜色
- `<br>` 换行
- `</>` Html万用闭合
> **注意!Html嵌套可能会有问题, 不建议过多嵌套**
Markdown语法支持:
- `**text**` 加粗
- `*text*` 斜体
- `__text__` 下划线
- `~~text~~` 删除线
- `[text](url)` 链接
> **注意!Html和Markdown语法虽然可以同时使用,但是不保证所有语法都能正常工作, 建议只使用其中一种**
> **目前语法解析属于测试阶段,欢迎反馈或者提出Pr**
- 目前支持的Html标签: `<b>`, `<i>`, `<u>`, `<s>`, `<c>`, `<br>`, `</>`
- 目前支持的Markdown语法: `**`, `*`, `__`, `~~`, `[text](url)`
- 目前支持的变量:
- `{asctime}` 对应日志完整时间(`config.asctime`)
- `{time}` 对应日志简略时间(`config.time`)
- `{weekday}` 对应日志星期(`config.weekday`)
- `{date}` 对应日志日期(`config.date`)
**支持的Python版本**
- Python 3.13.5
- Python 3.13.4
- Python 3.13.3
- Python 3.13.2
- Python 3.13.1
- Python 3.13.0
(低版本未经测试, 不保证兼容性)
## 安装
暂无安装包, 请使用release发布版或直接clone代码到本地/使用pip安装
```bash
pip install logiliteal
```
## 文档
暂无文档, 请查看代码注释
## 示例
```python
# 导入
from logiliteal import Logger
# 或 import logiliteal(不推荐)
# 实例化
logger = Logger()
#使用功能
logger.info("这是一条信息日志")
logger.warn("这是一条带有前缀的警告日志", prefix="114514")
logger.critical("这是一条带有前缀并且日志等级不同的严重错误日志", prefix="114514", level=55)
# 自定义配置
from logiliteal import set_config, get_config
# 读取配置
print(get_config("console_format"))
# 默认会输出时间、日志等级、日志前缀、日志消息
# 时间格式: {asctime}
# 日志等级: {levelname}
# 日志前缀: {prefix}
# 日志消息: {message}
# 输出: "{asctime} {levelname} | {prefix}{message}"
# 更改配置
set_config("console_format", "{asctime} {levelname} | {message}")
# 如果遇到函数名冲突, 可以用别名代替:
log_set_config = set_config
log_set_config("console_format", "{asctime} {levelname} | {message}")
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Nanaloveyuki/py-logiliteal",
"name": "logiliteal",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.12",
"maintainer_email": null,
"keywords": "logging, color, format",
"author": "Nanaloveyuki",
"author_email": "3541766758@qq.com",
"download_url": "https://files.pythonhosted.org/packages/ef/fd/05d6fa838b7f65e7f41940c127bfd3fb540e16c46f0d9183a2279b1bd9a9/logiliteal-0.1.3.tar.gz",
"platform": null,
"description": "## \u4ecb\u7ecd\r\n**\u7279\u70b9**\r\n- py-logiliteal \u662f\u4e00\u4e2a\u7b80\u5355\u7684\u3001\u73b0\u4ee3\u5316\u7684\u3001\u5177\u6709\u8272\u5f69\u7684\u65e5\u5fd7\u8bb0\u5f55\u5668\r\n- py-logiliteal \u63d0\u4f9b\u4e86\u7b80\u5355\u7684\u914d\u7f6e\u3001\u683c\u5f0f\u5316\u3001\u989c\u8272\u3001\u524d\u7f00\u7b49\u529f\u80fd\r\n- py-logiliteal \u63d0\u4f9b\u4e86\u7b80\u5355\u7684\u65e5\u5fd7\u7b49\u7ea7, \u53ef\u4ee5\u81ea\u5b9a\u4e49\u65e5\u5fd7\u7b49\u7ea7, \u65e5\u5fd7\u683c\u5f0f, \u65e5\u5fd7\u989c\u8272, \u65e5\u5fd7\u524d\u7f00\u7b49\r\n\r\n**\u5141\u8bb8\u5d4c\u5165**\r\npy-logiliteal \u5141\u8bb8\u5d4c\u5165\u5230\u5176\u4ed6\u9879\u76ee\u4e2d, \u5e76\u6839\u636e\u9700\u8981\u81ea\u5b9a\u4e49\u65e5\u5fd7\u8bb0\u5f55\u5668\r\n\u540c\u65f6\u4e5f\u652f\u6301pip\u5b89\u88c5\r\n```bash\r\npip install logiliteal\r\n```\r\n\r\n**\u652f\u6301\u9ad8\u53ef\u6269\u5c55\u7684\u6837\u5f0f**\r\n- \u652f\u6301\u4f7f\u7528HEX\u5341\u516d\u8fdb\u5236\u989c\u8272\u4ee3\u7801`<#ffffff>text</>`\u6e32\u67d3\u989c\u8272\r\n- \u652f\u6301\u4f7f\u7528\u5360\u4f4d\u7b26`{placeholder}`\u6e32\u67d3\u53d8\u91cf(\u53ef\u624b\u52a8\u6269\u5c55)\r\n- \u652f\u6301\u90e8\u5206Html\u6216Markdown\u8bed\u6cd5(\u5982`<b>text</b>`)\r\n- \u652f\u6301\u81ea\u5b9a\u4e49\u65e5\u5fd7\u683c\u5f0f\u548c\u65e5\u5fd7\u989c\u8272\r\n\r\nHtml\u8bed\u6cd5\u652f\u6301:\r\n- `<b>text</b>` \u52a0\u7c97\r\n- `<i>text</i>` \u659c\u4f53\r\n- `<u>text</u>` \u4e0b\u5212\u7ebf\r\n- `<s>text</s>` \u5220\u9664\u7ebf\r\n- `<c>` \u6e05\u9664\u989c\u8272\r\n- `<br>` \u6362\u884c\r\n- `</>` Html\u4e07\u7528\u95ed\u5408\r\n\r\n> **\u6ce8\u610f!Html\u5d4c\u5957\u53ef\u80fd\u4f1a\u6709\u95ee\u9898, \u4e0d\u5efa\u8bae\u8fc7\u591a\u5d4c\u5957**\r\n\r\nMarkdown\u8bed\u6cd5\u652f\u6301:\r\n- `**text**` \u52a0\u7c97\r\n- `*text*` \u659c\u4f53\r\n- `__text__` \u4e0b\u5212\u7ebf\r\n- `~~text~~` \u5220\u9664\u7ebf\r\n- `[text](url)` \u94fe\u63a5\r\n\r\n> **\u6ce8\u610f!Html\u548cMarkdown\u8bed\u6cd5\u867d\u7136\u53ef\u4ee5\u540c\u65f6\u4f7f\u7528,\u4f46\u662f\u4e0d\u4fdd\u8bc1\u6240\u6709\u8bed\u6cd5\u90fd\u80fd\u6b63\u5e38\u5de5\u4f5c, \u5efa\u8bae\u53ea\u4f7f\u7528\u5176\u4e2d\u4e00\u79cd**\r\n\r\n> **\u76ee\u524d\u8bed\u6cd5\u89e3\u6790\u5c5e\u4e8e\u6d4b\u8bd5\u9636\u6bb5,\u6b22\u8fce\u53cd\u9988\u6216\u8005\u63d0\u51faPr**\r\n- \u76ee\u524d\u652f\u6301\u7684Html\u6807\u7b7e: `<b>`, `<i>`, `<u>`, `<s>`, `<c>`, `<br>`, `</>`\r\n- \u76ee\u524d\u652f\u6301\u7684Markdown\u8bed\u6cd5: `**`, `*`, `__`, `~~`, `[text](url)`\r\n- \u76ee\u524d\u652f\u6301\u7684\u53d8\u91cf:\r\n - `{asctime}` \u5bf9\u5e94\u65e5\u5fd7\u5b8c\u6574\u65f6\u95f4(`config.asctime`)\r\n - `{time}` \u5bf9\u5e94\u65e5\u5fd7\u7b80\u7565\u65f6\u95f4(`config.time`)\r\n - `{weekday}` \u5bf9\u5e94\u65e5\u5fd7\u661f\u671f(`config.weekday`)\r\n - `{date}` \u5bf9\u5e94\u65e5\u5fd7\u65e5\u671f(`config.date`)\r\n\r\n**\u652f\u6301\u7684Python\u7248\u672c**\r\n- Python 3.13.5\r\n- Python 3.13.4\r\n- Python 3.13.3\r\n- Python 3.13.2\r\n- Python 3.13.1\r\n- Python 3.13.0\r\n(\u4f4e\u7248\u672c\u672a\u7ecf\u6d4b\u8bd5, \u4e0d\u4fdd\u8bc1\u517c\u5bb9\u6027)\r\n\r\n## \u5b89\u88c5\r\n\u6682\u65e0\u5b89\u88c5\u5305, \u8bf7\u4f7f\u7528release\u53d1\u5e03\u7248\u6216\u76f4\u63a5clone\u4ee3\u7801\u5230\u672c\u5730/\u4f7f\u7528pip\u5b89\u88c5\r\n```bash\r\npip install logiliteal\r\n```\r\n\r\n## \u6587\u6863\r\n\u6682\u65e0\u6587\u6863, \u8bf7\u67e5\u770b\u4ee3\u7801\u6ce8\u91ca\r\n\r\n## \u793a\u4f8b\r\n```python\r\n# \u5bfc\u5165\r\nfrom logiliteal import Logger\r\n# \u6216 import logiliteal(\u4e0d\u63a8\u8350)\r\n\r\n# \u5b9e\u4f8b\u5316\r\nlogger = Logger()\r\n\r\n#\u4f7f\u7528\u529f\u80fd\r\nlogger.info(\"\u8fd9\u662f\u4e00\u6761\u4fe1\u606f\u65e5\u5fd7\")\r\n\r\nlogger.warn(\"\u8fd9\u662f\u4e00\u6761\u5e26\u6709\u524d\u7f00\u7684\u8b66\u544a\u65e5\u5fd7\", prefix=\"114514\")\r\n\r\nlogger.critical(\"\u8fd9\u662f\u4e00\u6761\u5e26\u6709\u524d\u7f00\u5e76\u4e14\u65e5\u5fd7\u7b49\u7ea7\u4e0d\u540c\u7684\u4e25\u91cd\u9519\u8bef\u65e5\u5fd7\", prefix=\"114514\", level=55)\r\n\r\n# \u81ea\u5b9a\u4e49\u914d\u7f6e\r\nfrom logiliteal import set_config, get_config\r\n# \u8bfb\u53d6\u914d\u7f6e\r\nprint(get_config(\"console_format\"))\r\n# \u9ed8\u8ba4\u4f1a\u8f93\u51fa\u65f6\u95f4\u3001\u65e5\u5fd7\u7b49\u7ea7\u3001\u65e5\u5fd7\u524d\u7f00\u3001\u65e5\u5fd7\u6d88\u606f\r\n# \u65f6\u95f4\u683c\u5f0f: {asctime}\r\n# \u65e5\u5fd7\u7b49\u7ea7: {levelname}\r\n# \u65e5\u5fd7\u524d\u7f00: {prefix}\r\n# \u65e5\u5fd7\u6d88\u606f: {message}\r\n# \u8f93\u51fa: \"{asctime} {levelname} | {prefix}{message}\"\r\n\r\n# \u66f4\u6539\u914d\u7f6e\r\nset_config(\"console_format\", \"{asctime} {levelname} | {message}\")\r\n\r\n# \u5982\u679c\u9047\u5230\u51fd\u6570\u540d\u51b2\u7a81, \u53ef\u4ee5\u7528\u522b\u540d\u4ee3\u66ff:\r\nlog_set_config = set_config\r\nlog_set_config(\"console_format\", \"{asctime} {levelname} | {message}\")\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\u7b80\u6d01,\u9ad8\u6269\u5c55\u6027,\u53ef\u81ea\u5b9a\u4e49\u7684\u65e5\u5fd7\u5e93 / Simple, high extensibility, and customizable logging library",
"version": "0.1.3",
"project_urls": {
"Bug Reports": "https://github.com/Nanaloveyuki/py-logiliteal/issues",
"Homepage": "https://github.com/Nanaloveyuki/py-logiliteal",
"Source": "https://github.com/Nanaloveyuki/py-logiliteal/"
},
"split_keywords": [
"logging",
" color",
" format"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5c36b7637e9b9e1faed189e03ec6ef797b944d86684960d00e8e0d0e3038c30e",
"md5": "7c3b2cd94b93519cad868fd265f7cfdf",
"sha256": "21b8704c0791305ecce3b8b519c8bddafa6e083c982e1cd16c24763033b21acd"
},
"downloads": -1,
"filename": "logiliteal-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7c3b2cd94b93519cad868fd265f7cfdf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.12",
"size": 21997,
"upload_time": "2025-07-29T09:26:58",
"upload_time_iso_8601": "2025-07-29T09:26:58.445730Z",
"url": "https://files.pythonhosted.org/packages/5c/36/b7637e9b9e1faed189e03ec6ef797b944d86684960d00e8e0d0e3038c30e/logiliteal-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "effd05d6fa838b7f65e7f41940c127bfd3fb540e16c46f0d9183a2279b1bd9a9",
"md5": "08d3f8c84d1383e89d2cf562133b2c33",
"sha256": "0b7abb8b431eb416061fb3797d7388f6db9726d168331e7bd9414007343b689e"
},
"downloads": -1,
"filename": "logiliteal-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "08d3f8c84d1383e89d2cf562133b2c33",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.12",
"size": 13946,
"upload_time": "2025-07-29T09:26:59",
"upload_time_iso_8601": "2025-07-29T09:26:59.779591Z",
"url": "https://files.pythonhosted.org/packages/ef/fd/05d6fa838b7f65e7f41940c127bfd3fb540e16c46f0d9183a2279b1bd9a9/logiliteal-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-29 09:26:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Nanaloveyuki",
"github_project": "py-logiliteal",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "logiliteal"
}
JSON
