更新日志 添加 lndl 文档 更新rspress
This commit is contained in:
parent
95a7ed0683
commit
ad3036a563
@ -16,6 +16,13 @@
|
||||
"collapsible": true,
|
||||
"collapsed": true
|
||||
},
|
||||
{
|
||||
"type": "dir",
|
||||
"name": "lib-not-dr",
|
||||
"label": "lib not dr 文档",
|
||||
"collapsed": true,
|
||||
"collapsible": true
|
||||
},
|
||||
{
|
||||
"type": "dir",
|
||||
"name": "change_log",
|
||||
|
@ -42,3 +42,19 @@
|
||||
- 去看 `requirements.txt` 吧
|
||||
- Updated all dependency version numbers
|
||||
- Go see `requirements.txt`
|
||||
- 去除了 `rtoml` 的依赖
|
||||
- 改为 `tomli` 和 `tomlkit` 组合
|
||||
- Removed `rtoml` dependency
|
||||
- Change to `tomli` and `tomlkit` combination
|
||||
- 删除了 `requirement-xxx.txt`
|
||||
- 现在使用 `gen_require.py 0/1/2` 来先生成然后安装依赖
|
||||
- > python gen_require.py 0 ( 运行 / run only )
|
||||
- > python gen_require.py 1 ( 构建 / build )
|
||||
- > python gen_require.py 2 ( 开发 / develop )
|
||||
- `gen_require.py` 会在 `requirements.txt` 中生成依赖
|
||||
- Delete `requirement-xxx.txt`
|
||||
- Now use `gen_require.py 0/1/2` to generate and install dependencies
|
||||
- > python gen_require.py 0 ( run only )
|
||||
- > python gen_require.py 1 ( build )
|
||||
- > python gen_require.py 2 ( develop )
|
||||
- `gen_require.py` will generate dependencies in `requirements.txt`
|
||||
|
105
docs/main/lib-not-dr.md
Normal file
105
docs/main/lib-not-dr.md
Normal file
@ -0,0 +1,105 @@
|
||||
# lib-not-dr
|
||||
|
||||
A python lib came from [Difficult Rocket](https://github.com/shenjackyuanjie/Difficult-Rocket) development
|
||||
|
||||
一个在 [Difficult Rocket](https://github.com/shenjackyuanjie/Difficult-Rocket) 开发中 分离出来的 python 库
|
||||
|
||||
## Information/信息
|
||||
|
||||
- Version / 版本: 0.3.11
|
||||
- Author / 作者: shenjackyuanjie <3695888@qq.com>
|
||||
|
||||
[shenjackyuanjie](https://github.com/shenjackyuanjie)
|
||||
|
||||
> [更新日志|Change Log](docs/change_logs)
|
||||
|
||||
### License/许可证
|
||||
|
||||
[MPL-2.0](https://www.mozilla.org/en-US/MPL/2.0/)
|
||||
|
||||
## 安装/Install
|
||||
|
||||
```bash title="install.sh"
|
||||
pip install lib-not-dr
|
||||
pip install lib-not-dr[nuitka]
|
||||
# install with nuitka support
|
||||
# 安装支持 nuitka 的版本
|
||||
```
|
||||
|
||||
## 使用/Usage
|
||||
|
||||
### Logger
|
||||
|
||||
> WIP
|
||||
> 等待 0.4.0
|
||||
|
||||
```python title="logger.py"
|
||||
from lib_not_dr import loggers
|
||||
|
||||
logger = loggers.get_logger("test")
|
||||
|
||||
logger.fine('Hello World!')
|
||||
logger.debug('Hello World!')
|
||||
logger.trace('Hello tracing!')
|
||||
logger.info('Hello World!') # info!
|
||||
logger.warn('warnnnnnnn')
|
||||
logger.error('Hello World!')
|
||||
logger.fatal('good bye world')
|
||||
|
||||
# tag
|
||||
logger.info('this message if from tag', tag='test')
|
||||
logger.debug('this debug log if from admin', tag='admin')
|
||||
|
||||
# end
|
||||
logger.debug('and this message ends with none', end=' ')
|
||||
logger.trace('so this message will be in the same line', tag='same line!')
|
||||
```
|
||||
|
||||
### Nuitka pyproject paser
|
||||
|
||||
> `pyproject.toml` 内的配置
|
||||
>
|
||||
> Config in `pyproject.toml`
|
||||
|
||||
前往 [example/nuitka](/example/nuitka) 查看更多例子
|
||||
|
||||
```toml title="pyproject.toml"
|
||||
[tool.lndl.nuitka.cli]
|
||||
main = "main.py"
|
||||
# --main=main.py
|
||||
standalone = true
|
||||
onefile = false
|
||||
[tool.lndl.nuitka]
|
||||
script = "xxx.py"
|
||||
```
|
||||
|
||||
> 通过 `lndl_nuitka` 命令行工具使用
|
||||
>
|
||||
> Use with `lndl_nuitka` command line tool
|
||||
|
||||
> 建议使用 `pip install lib-not-dr[nuitka]` 安装 lib-not-dr
|
||||
|
||||
```bash
|
||||
lndl_nuitka .
|
||||
lndl_nuitka . -- --onefile
|
||||
# add --onefile to nuitka
|
||||
lndl_nuitka . -y
|
||||
# run without confirmation
|
||||
lndl_nuitka . -n
|
||||
# do not run
|
||||
```
|
||||
|
||||
> 通过 `lib_not_dr.nuitka.reader` 模块使用
|
||||
>
|
||||
> Use with `lib_not_dr.nuitka.reader`
|
||||
|
||||
```python
|
||||
from tomli import loads
|
||||
from lib_not_dr.nuitka.reader import main, run_nuitka
|
||||
|
||||
pyproject_toml = loads(open("pyproject.toml", "r").read())
|
||||
nuitka_config = pyproject_toml["tool"]["lndl"]["nuitka"]
|
||||
nuitka_config["product_version"] = "0.1.0"
|
||||
command = main(nuitka_config)
|
||||
run_nuitka(command)
|
||||
```
|
7
docs/main/lib-not-dr/_meta.json
Normal file
7
docs/main/lib-not-dr/_meta.json
Normal file
@ -0,0 +1,7 @@
|
||||
[
|
||||
{
|
||||
"type": "dir",
|
||||
"name": "change_logs",
|
||||
"label": "lndl 更新日志"
|
||||
}
|
||||
]
|
7
docs/main/lib-not-dr/change_logs.md
Normal file
7
docs/main/lib-not-dr/change_logs.md
Normal file
@ -0,0 +1,7 @@
|
||||
# lndl 更新日志
|
||||
|
||||
## [0.4.0](./0-4.md)
|
||||
|
||||
## [0.3.0](./0-3.md)
|
||||
|
||||
## [old](./old.md)
|
66
docs/main/lib-not-dr/change_logs/0-3.md
Normal file
66
docs/main/lib-not-dr/change_logs/0-3.md
Normal file
@ -0,0 +1,66 @@
|
||||
# lndl 0.3
|
||||
|
||||
## 0.3.11
|
||||
|
||||
- 修复了 `Logger` 任意等级消息 `flush` 默认为 `True`
|
||||
- 现在为 `None`
|
||||
|
||||
## 0.3.10
|
||||
|
||||
- 修复了 `LogMessage` 在传入非字符串时会因为 `str.join` 只支持 `str` 类型报错
|
||||
|
||||
## 0.3.9
|
||||
|
||||
- 改进了 `lndl-nuitka` 在没有找到 toml 库的时候的报错
|
||||
- 这下看的懂了吧 ?
|
||||
|
||||
## 0.3.8
|
||||
|
||||
- 为 `logger` 添加了 `default_tag` 属性
|
||||
- 详情请查看 `0.4` 文档
|
||||
|
||||
## 0.3.7
|
||||
|
||||
- lndl-nuitka 现在不会再输出那一堆 debug 信息了
|
||||
|
||||
### CompilerHelper
|
||||
|
||||
- 修复了如果未定义 `icon_path` 时 会报错的问题
|
||||
- 这大概是最后一次修复了
|
||||
- 0.4 会删除这一部分
|
||||
|
||||
## 0.3.6
|
||||
|
||||
- logger 的 `info` 更白了
|
||||
|
||||
## 0.3.5
|
||||
|
||||
- 向后移植了一些 `0.4` 的 logger 改动
|
||||
- 其实就是懒得发 0.4, 先测试一下再说
|
||||
|
||||
## 0.3.2/3/4
|
||||
|
||||
仅用于测试新的 `pdm publish` hook
|
||||
|
||||
## 0.3.1
|
||||
|
||||
将 Python 包的 `license` 改为 `MPL-2.0`
|
||||
|
||||
## 0.3.0
|
||||
|
||||
> logger 继续后延
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- [x] 修改配置路径
|
||||
- 从 `[tool.lndl.nuitka]` 变为 `[tool.lndl.nuitka.cli]`
|
||||
- [x] 添加新配置
|
||||
- 添加 `[tool.lndl.nuitka.script]`
|
||||
- 用于项目动态修改 nuitka 脚本中的信息
|
||||
- 例如 `file-version` `product-version` 等
|
||||
|
||||
- 重构了一部分解析逻辑
|
||||
- 现在配置路径位于 `[tool.lndl.nuitka.cli]`
|
||||
- 可以添加脚本用于动态解析依赖
|
||||
- `[tool.lndl.nuitka]`
|
||||
- `script = "script.py"`
|
45
docs/main/lib-not-dr/change_logs/0-4.md
Normal file
45
docs/main/lib-not-dr/change_logs/0-4.md
Normal file
@ -0,0 +1,45 @@
|
||||
# lndl 0.4.0 (draft)
|
||||
|
||||
## Logger
|
||||
|
||||
- [x] 完成配置解析
|
||||
- [x] 支持读取配置之后自动应用
|
||||
- [ ] 达到可用级别
|
||||
|
||||
- `Outstream`
|
||||
- `FileCacheOutputStream`
|
||||
- 现在如果输入的文件名包含 `{time}`
|
||||
- 会自动替换为 `time.strftime("%Y-%m-%d_%H-%M-%S")`
|
||||
- 修复了一些之前没有发现的问题
|
||||
- `config`
|
||||
- 添加了 `get_logger_from_old`
|
||||
- 用于从现有 logger 中获取一个新的 logger
|
||||
- 现在 `info` 级别的默认颜色更白了 (255, 255, 255)
|
||||
- `Logger`
|
||||
- 添加了 `default_tag` 属性 (已经在 `0.3.8` 中添加)
|
||||
- 用于设置默认的 tag
|
||||
- 默认为 `None` (无默认 tag)
|
||||
- 可以通过 `logger.tag = "tag"` 来设置
|
||||
- 或者 `logger.set_tag("tag")` 来设置
|
||||
- 可以链式调用
|
||||
- 类似
|
||||
- `self.logger = config.get_logger("root").set_tag("tag")`
|
||||
- 也可以通过 `logger.tag = None` 来取消默认 tag
|
||||
- 或者 `logger.clear_tag()` 来清除默认 tag
|
||||
- 添加了 `get_config` 函数 (已经在 `0.3.0` 中添加)
|
||||
- 用于获取全局配置
|
||||
- 我也不确定有啥用捏
|
||||
- 添加了 `read_config` 函数 (已经在 `0.3.0` 中添加)
|
||||
- 用于向指定 `ConfigStorage`/全局 `ConfigStorage` 实例中添加配置
|
||||
- 添加了 `get_logger` 函数 (已经在 `0.3.0` 中添加)
|
||||
- 用于从指定 `ConfigStorage`/全局 `ConfigStorage` 实例中获取指定名称的 `Logger` 实例
|
||||
- 添加了 `clone_logger` 函数 (已经在 `0.3.0` 中添加)
|
||||
- 用于克隆一个新的配置相同的 `Logger` 实例
|
||||
- 修复了 `Logger` 任意等级消息 `flush` 默认为 `True` (已经在 `0.3.11` 中修复)
|
||||
- 现在为 `None`
|
||||
- 将 `logger` 模块重命名为 `loggers`
|
||||
|
||||
|
||||
## Nuitka Compiler Helper
|
||||
|
||||
- [ ] 移除 CompilerHelper 和他的附属部分
|
17
docs/main/lib-not-dr/change_logs/_meta.json
Normal file
17
docs/main/lib-not-dr/change_logs/_meta.json
Normal file
@ -0,0 +1,17 @@
|
||||
[
|
||||
{
|
||||
"type": "file",
|
||||
"name": "0-4",
|
||||
"label": "lndl 0.4 更新日志 (草稿)"
|
||||
},
|
||||
{
|
||||
"type": "file",
|
||||
"name": "0-3",
|
||||
"label": "lndl 0.3 更新日志"
|
||||
},
|
||||
{
|
||||
"type": "file",
|
||||
"name": "old",
|
||||
"label": "lndl 0.1-0.2 更新日志"
|
||||
}
|
||||
]
|
184
docs/main/lib-not-dr/change_logs/old.md
Normal file
184
docs/main/lib-not-dr/change_logs/old.md
Normal file
@ -0,0 +1,184 @@
|
||||
# lndl 老版本的更新日志
|
||||
|
||||
## 0.2.3
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 现在如果没有找到 toml 解析器
|
||||
- 提示安装库 的信息里不再带有 `tomllib` 了
|
||||
- 标准库也想装 ? 🤣
|
||||
|
||||
## 0.2.2
|
||||
|
||||
### Logger
|
||||
|
||||
- `MainFormatter`
|
||||
- `_trace_format`
|
||||
- 通过不需要获取绝对路径时直接使用获取到的路径减少用时
|
||||
- `LogMessage`
|
||||
- 不再继承 `Options`
|
||||
- `Options` 的初始化太慢了
|
||||
- 终于是开始扣时间了
|
||||
- `ConfigStorage`
|
||||
- 完善了功能 (虽然还是 WIP)
|
||||
|
||||
## 0.2.1
|
||||
|
||||
> logger 继续后延
|
||||
|
||||
### Fix
|
||||
|
||||
- `Logger`
|
||||
- `MainFormatter`
|
||||
- 修复了会导致 `ColorFormatter` 崩溃的问题
|
||||
|
||||
## 0.2.0
|
||||
|
||||
> 内容和 0.2.0-rc.10 相同
|
||||
|
||||
## 0.2.0-rc.10
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 将 `lndl-nuitka` 中的 `subprocess.run` 方法修改为
|
||||
- Linux / MacOS: `subprocess.run(shell=False)`
|
||||
- Windows: `subprocess.run(shell=True)`
|
||||
|
||||
## 0.2.0-rc.9
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 将运行方法修改为 `subprocess.run(shell=False)`
|
||||
|
||||
## 0.2.0-rc.4
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 在 `lndl-nuitka` 中使用新添加的 `subprocess_to_bash` 函数展示命令
|
||||
- 保证展示的命令可以直接运行
|
||||
|
||||
> 真的就是在刷版本号啊
|
||||
|
||||
## 0.2.0-rc.3
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 在 `arg_parser` 中添加了函数 `subprocess_to_bash`
|
||||
- 用于将 `arg_parser` 中的参数转换为 `bash` 命令
|
||||
- 理论上可以直接运行
|
||||
|
||||
## 0.2.0-rc.1/2
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 修复了一些细节问题 (反正我懒得统计具体内容了)
|
||||
- 现在不会在没有给定附加参数的时候报 `invalid args:` 了
|
||||
- 似乎没有别的细节了?
|
||||
|
||||
## 0.2.0-beta.2
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 可以使用 `--` 单独添加参数了
|
||||
- 例如 `lndl-nuitka -- --onefile`
|
||||
- 会将 `--onefile` 添加到 `nuitka` 的参数中
|
||||
|
||||
## 0.2.0-beta.0/1
|
||||
|
||||
### 重构
|
||||
|
||||
- 重构了文件目录结构
|
||||
- 保证 `setuptools` 可以正常工作
|
||||
|
||||
### lndl-nuitka
|
||||
|
||||
- 添加了脚本 `lndl-nuitka`
|
||||
- 用于解析 `pyproject.toml` 中的 `tool.lndl.nuitka` 部分
|
||||
|
||||
## 0.2.0-alpha0
|
||||
|
||||
### Logger
|
||||
|
||||
- 添加了 Logger (虽说 0.1.8 就有了)
|
||||
- 目前入口点位于 `lib_not_dr.logger.logger.Logger`
|
||||
|
||||
## 0.1.8
|
||||
|
||||
- 为 `types.Options` 添加了 `_check_option` 选项
|
||||
- 为 `True` 时 会检查参数是否合法 (在类属性中已经定义了)
|
||||
|
||||
### Logger
|
||||
|
||||
- WIP (wait for 0.2.0)
|
||||
|
||||
## 0.1.7
|
||||
|
||||
- 修复了 `CompilerHelper` 中的问题
|
||||
- 重复添加 `--output-dir` 参数
|
||||
- 参数喜加 2
|
||||
- `--onefile`
|
||||
- `--onefile-tempdir-spec`
|
||||
|
||||
## 0.1.6
|
||||
|
||||
- 优化了 `CompilerHelper` 的一些周围实现
|
||||
- 参数喜加一
|
||||
- `--report`
|
||||
|
||||
## 0.1.5
|
||||
|
||||
- 修复了 `types.Options` 中的 `as_markdown` 实现细节
|
||||
- 现在不会长度溢出了
|
||||
|
||||
## 0.1.4
|
||||
|
||||
- 更改了 `types.Options` 中的 `as_markdown` 实现方式
|
||||
- 原来的实现会导致 如果终端长度 > 所需长度 时, 循环一直进行
|
||||
- 同时现在分配长度是均分
|
||||
|
||||
## 0.1.3
|
||||
|
||||
- 修改了 `README.md` 内的版本号
|
||||
|
||||
## 0.1.2
|
||||
|
||||
- 改进了 `types.Options`
|
||||
- 现在 `as_markdown` 如果没有指定最长长度 会自动适配输出所用终端的宽度
|
||||
- 同时如果指定最大长度, 也会更灵活的适配
|
||||
- 补全了一些文档
|
||||
|
||||
## 0.1.1
|
||||
|
||||
- 为 `CompilerHelper` 添加了 `remove_output` 的选项
|
||||
- 用于删除编译后的过程文件
|
||||
|
||||
## 0.1.0
|
||||
|
||||
- 添加了一些文档
|
||||
- `CompilerHelper`
|
||||
- 添加了 `run_after_build` 参数
|
||||
- 用于在编译完成后执行程序
|
||||
- 添加了 `compat_nuitka_version` 参数
|
||||
- 用于验证 nuitka 版本是否兼容
|
||||
|
||||
## 0.0.4
|
||||
|
||||
添加了项目的 url
|
||||
|
||||
## 0.0.3
|
||||
|
||||
继续添加了一些文档
|
||||
|
||||
## 0.0.2
|
||||
|
||||
添加了一些文档
|
||||
|
||||
## 0.0.1
|
||||
|
||||
- 添加了
|
||||
- `nuitka.compile`
|
||||
- `CompilerHelper`
|
||||
- `types.options`
|
||||
- `Options`
|
||||
- `types.version`
|
||||
- `Version`
|
@ -8,7 +8,7 @@
|
||||
"preview": "rspress preview"
|
||||
},
|
||||
"dependencies": {
|
||||
"rspress": "^1.8.3",
|
||||
"rspress": "^1.9.0",
|
||||
"ts-node": "^10.9.2",
|
||||
"typescript": "^5.3.3"
|
||||
}
|
||||
|
1219
pnpm-lock.yaml
generated
1219
pnpm-lock.yaml
generated
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user