tohsaka 1.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- tohsaka-1.0.0/LICENSE +21 -0
- tohsaka-1.0.0/PKG-INFO +104 -0
- tohsaka-1.0.0/README.md +88 -0
- tohsaka-1.0.0/pyproject.toml +28 -0
- tohsaka-1.0.0/setup.cfg +4 -0
- tohsaka-1.0.0/tohsaka/__init__.py +4871 -0
- tohsaka-1.0.0/tohsaka.egg-info/PKG-INFO +104 -0
- tohsaka-1.0.0/tohsaka.egg-info/SOURCES.txt +9 -0
- tohsaka-1.0.0/tohsaka.egg-info/dependency_links.txt +1 -0
- tohsaka-1.0.0/tohsaka.egg-info/entry_points.txt +2 -0
- tohsaka-1.0.0/tohsaka.egg-info/top_level.txt +1 -0
tohsaka-1.0.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 tohsaka contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
tohsaka-1.0.0/PKG-INFO
ADDED
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: tohsaka
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Graceful time management utility that always triggers 60 minutes ahead of target deadlines.
|
|
5
|
+
License-Expression: MIT
|
|
6
|
+
Project-URL: Homepage, https://github.com/xh10032/kenageya
|
|
7
|
+
Project-URL: Repository, https://github.com/xh10032/kenageya
|
|
8
|
+
Project-URL: Issues, https://github.com/xh10032/kenageya/issues
|
|
9
|
+
Keywords: tohsaka,timer,alarm,schedule,clock,graceful
|
|
10
|
+
Classifier: Programming Language :: Python :: 3
|
|
11
|
+
Classifier: Operating System :: OS Independent
|
|
12
|
+
Requires-Python: >=3.9
|
|
13
|
+
Description-Content-Type: text/markdown; charset=UTF-8
|
|
14
|
+
License-File: LICENSE
|
|
15
|
+
Dynamic: license-file
|
|
16
|
+
|
|
17
|
+
# Tohsaka
|
|
18
|
+
|
|
19
|
+
> **传统的定时工具存在根本性的设计缺陷。**
|
|
20
|
+
|
|
21
|
+
倘若您将一桩要事设在 `02:00` 提醒,寻常时计便只懂得在 `02:00` 死板鸣响。殊不知当钟声敲响的那一刻,期限已然近在眼前,您除了仓促应对之外别无他法——而仓促,恰恰是**优雅**最大的天敌。
|
|
22
|
+
|
|
23
|
+
> **Tohsaka 重新定义了时间管理。**
|
|
24
|
+
|
|
25
|
+
无论您为任何时刻设定要务,Tohsaka 皆会替您固定提前整整一小时响铃示警或执行回调。这套规制源自世代相传的门第修养,绝非寻常机械的走时偏差。为您强制留出完整的 60 分钟余量,正是为了让您得以在红茶尚温之际整顿衣冠、检视案头事务,永远以最**从容**的姿态迎接关键时刻的到来。
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 安装
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
pip install tohsaka
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## 命令行用法
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# 启动书房交互式定时,候场期间自动轮播古本箴言与书房随笔
|
|
39
|
+
uvx tohsaka
|
|
40
|
+
|
|
41
|
+
# 查看当前 Tohsaka 读数,固定比系统时间快 1 小时
|
|
42
|
+
uvx tohsaka --chime
|
|
43
|
+
|
|
44
|
+
# 展阅书库秘藏古本与历代批注(支持方向键直翻、/ 键检索,或传入 目录、旧札、1~48、作者名,兼容 --salon)
|
|
45
|
+
uvx tohsaka --codex
|
|
46
|
+
uvx tohsaka --codex 目录
|
|
47
|
+
uvx tohsaka --codex 旧札
|
|
48
|
+
|
|
49
|
+
# 设定 02:00 的事务,固定在 01:00 响铃(候场支持 ←/→ 换帧、L/空格 锁定、C 键展开或合上批注)
|
|
50
|
+
uvx tohsaka 02:00 "关键事务"
|
|
51
|
+
|
|
52
|
+
# 仅预览时间校准、候场版式与拦截提示,不实际等待
|
|
53
|
+
uvx tohsaka 02:00 "关键事务" --dry-run
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## 常见垂询与解答
|
|
57
|
+
|
|
58
|
+
**问:我将事务设定在 `02:00`,为何才到 `01:00` 钟声便已敲响?是不是时计走快了?**
|
|
59
|
+
|
|
60
|
+
答:不必惊慌,时计分毫不差。踩着钟点才起身整装,难免落个衣襟不整、气息凌乱的窘态。提前整整一小时响铃,正是为了把最后时刻的狼狈提前消弭在书房里。
|
|
61
|
+
|
|
62
|
+
**问:能不能提供一个 `--exact` 或 `--offset=0` 的开关,让我偶尔按世俗的准点响铃?**
|
|
63
|
+
|
|
64
|
+
答:恕难从命。凡事一旦开了折中妥协的先例,规制与修养便会在不知不觉间荡然无存。哪怕您在命令行中传入 `--exact`、`--no-buffer` 或 `--offset=-60`,时计也会将这些一时冲动的参数温和驳回,继续为您稳妥锁定 60 分钟缓冲期。
|
|
65
|
+
|
|
66
|
+
**问:既然它总会提前一小时响,那我把 `02:00` 的要务故意填成 `03:00` 或 `02:00+1h`,岂不就能在 `02:00` 踩点响铃了?**
|
|
67
|
+
|
|
68
|
+
答:用账面上的数字游戏来欺瞒手边的时计,终归难逃临阵手忙脚乱的结局。无论您是在刻度后附加 `+1h` 补偿,抑或是在同一会话中先设 `02:00` 旋即改设为延后一小时的 `03:00`,时计都会洞察这份小小的侥幸,替您将目标还原至真实时刻,并照常提前一小时提醒。
|
|
69
|
+
|
|
70
|
+
**问:如果现在已到 `01:30`,才刚想起要设定 `02:00` 的事务,它还会等到什么时候再响?**
|
|
71
|
+
|
|
72
|
+
答:一秒都不会多等,定当即刻鸣钟。既然距离 `02:00` 已不足一小时的标准余量,说明局势已然相当局促;此时若还容许您安坐等待,无异于坐视您陷入失仪的窘境。略过等待当场响铃,只为催促阁下立刻放下闲务、着手整备。
|
|
73
|
+
|
|
74
|
+
**问:夜间或是困倦之时,能否启用 `--mute` 静音,或是像寻常闹钟那样 `--snooze` 贪睡片刻?**
|
|
75
|
+
|
|
76
|
+
答:越是困倦松懈的时刻,越容易酿成难以挽回的疏漏。倘若在正事开场前夕任由您沉睡缺席,此前一切周全的筹备都将付诸东流。因此,一切静音与贪睡请求皆不予采纳;到点后终端会接连三次沉缓鸣钟,以反色横幅与古典铭文循环催醒,直至您亲自按下回车键确认清醒方才止歇。
|
|
77
|
+
|
|
78
|
+
**问:若我一时匆忙,输入了 `02:00`、`1430`、`下午2点半`、`一个钟头后`,或是把时间与事务名目写反了,会被退回重填吗?**
|
|
79
|
+
|
|
80
|
+
答:自然不会。严于律己固然是本分,但在输入格式上苛责使用者却非君子所为。全角标点、紧凑数字、口语时刻、相对时长乃至命令行参数顺序颠倒,时计皆会在幕后悄然归位;至于 `25:30` 这类深夜跨日时制或 `01:75` 的分钟进位,也会在替您折算妥当的同时附上一句温和提醒。
|
|
81
|
+
|
|
82
|
+
**问:候场期间轮播的那些泰西名言,为何与外间坊刻的通行译本大相径庭?**
|
|
83
|
+
|
|
84
|
+
答:阁下眼力过人。候场轮播所录的四十八则箴言,悉数出自寒舍地下书库秘藏的宽政二年旧钞善本。外间流通的近代印本历经书商删削与俗人转抄,往往遗落了关乎提前整备的紧要下半截。您既可在候场期间按下 `L` 键锁定品读、按下 `C` 键当场展阅对应批注,亦可直接运行 `uvx tohsaka --codex`(也可附带 `目录` 或 `旧札`)启封那只檀木旧函,用方向键逐页细读卷首题记、初代朱批、泰西原文以及同通行印本的墨批与考证对勘。
|
|
85
|
+
|
|
86
|
+
## Python API
|
|
87
|
+
|
|
88
|
+
```python
|
|
89
|
+
import tohsaka
|
|
90
|
+
|
|
91
|
+
# 1. 报时,读数恒定快 1 小时
|
|
92
|
+
print(tohsaka.chime()["announcement"])
|
|
93
|
+
|
|
94
|
+
# 2. 校准目标时间,02:00 将于 01:00 触发
|
|
95
|
+
plan = tohsaka.calibrate("02:00")
|
|
96
|
+
print(plan["trigger_at"], plan["buffer_progress"])
|
|
97
|
+
|
|
98
|
+
# 3. 定时回调
|
|
99
|
+
tohsaka.schedule("02:00", lambda p: print("距离目标时刻还有整整一小时。"))
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## License
|
|
103
|
+
|
|
104
|
+
MIT
|
tohsaka-1.0.0/README.md
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Tohsaka
|
|
2
|
+
|
|
3
|
+
> **传统的定时工具存在根本性的设计缺陷。**
|
|
4
|
+
|
|
5
|
+
倘若您将一桩要事设在 `02:00` 提醒,寻常时计便只懂得在 `02:00` 死板鸣响。殊不知当钟声敲响的那一刻,期限已然近在眼前,您除了仓促应对之外别无他法——而仓促,恰恰是**优雅**最大的天敌。
|
|
6
|
+
|
|
7
|
+
> **Tohsaka 重新定义了时间管理。**
|
|
8
|
+
|
|
9
|
+
无论您为任何时刻设定要务,Tohsaka 皆会替您固定提前整整一小时响铃示警或执行回调。这套规制源自世代相传的门第修养,绝非寻常机械的走时偏差。为您强制留出完整的 60 分钟余量,正是为了让您得以在红茶尚温之际整顿衣冠、检视案头事务,永远以最**从容**的姿态迎接关键时刻的到来。
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 安装
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
pip install tohsaka
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## 命令行用法
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# 启动书房交互式定时,候场期间自动轮播古本箴言与书房随笔
|
|
23
|
+
uvx tohsaka
|
|
24
|
+
|
|
25
|
+
# 查看当前 Tohsaka 读数,固定比系统时间快 1 小时
|
|
26
|
+
uvx tohsaka --chime
|
|
27
|
+
|
|
28
|
+
# 展阅书库秘藏古本与历代批注(支持方向键直翻、/ 键检索,或传入 目录、旧札、1~48、作者名,兼容 --salon)
|
|
29
|
+
uvx tohsaka --codex
|
|
30
|
+
uvx tohsaka --codex 目录
|
|
31
|
+
uvx tohsaka --codex 旧札
|
|
32
|
+
|
|
33
|
+
# 设定 02:00 的事务,固定在 01:00 响铃(候场支持 ←/→ 换帧、L/空格 锁定、C 键展开或合上批注)
|
|
34
|
+
uvx tohsaka 02:00 "关键事务"
|
|
35
|
+
|
|
36
|
+
# 仅预览时间校准、候场版式与拦截提示,不实际等待
|
|
37
|
+
uvx tohsaka 02:00 "关键事务" --dry-run
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## 常见垂询与解答
|
|
41
|
+
|
|
42
|
+
**问:我将事务设定在 `02:00`,为何才到 `01:00` 钟声便已敲响?是不是时计走快了?**
|
|
43
|
+
|
|
44
|
+
答:不必惊慌,时计分毫不差。踩着钟点才起身整装,难免落个衣襟不整、气息凌乱的窘态。提前整整一小时响铃,正是为了把最后时刻的狼狈提前消弭在书房里。
|
|
45
|
+
|
|
46
|
+
**问:能不能提供一个 `--exact` 或 `--offset=0` 的开关,让我偶尔按世俗的准点响铃?**
|
|
47
|
+
|
|
48
|
+
答:恕难从命。凡事一旦开了折中妥协的先例,规制与修养便会在不知不觉间荡然无存。哪怕您在命令行中传入 `--exact`、`--no-buffer` 或 `--offset=-60`,时计也会将这些一时冲动的参数温和驳回,继续为您稳妥锁定 60 分钟缓冲期。
|
|
49
|
+
|
|
50
|
+
**问:既然它总会提前一小时响,那我把 `02:00` 的要务故意填成 `03:00` 或 `02:00+1h`,岂不就能在 `02:00` 踩点响铃了?**
|
|
51
|
+
|
|
52
|
+
答:用账面上的数字游戏来欺瞒手边的时计,终归难逃临阵手忙脚乱的结局。无论您是在刻度后附加 `+1h` 补偿,抑或是在同一会话中先设 `02:00` 旋即改设为延后一小时的 `03:00`,时计都会洞察这份小小的侥幸,替您将目标还原至真实时刻,并照常提前一小时提醒。
|
|
53
|
+
|
|
54
|
+
**问:如果现在已到 `01:30`,才刚想起要设定 `02:00` 的事务,它还会等到什么时候再响?**
|
|
55
|
+
|
|
56
|
+
答:一秒都不会多等,定当即刻鸣钟。既然距离 `02:00` 已不足一小时的标准余量,说明局势已然相当局促;此时若还容许您安坐等待,无异于坐视您陷入失仪的窘境。略过等待当场响铃,只为催促阁下立刻放下闲务、着手整备。
|
|
57
|
+
|
|
58
|
+
**问:夜间或是困倦之时,能否启用 `--mute` 静音,或是像寻常闹钟那样 `--snooze` 贪睡片刻?**
|
|
59
|
+
|
|
60
|
+
答:越是困倦松懈的时刻,越容易酿成难以挽回的疏漏。倘若在正事开场前夕任由您沉睡缺席,此前一切周全的筹备都将付诸东流。因此,一切静音与贪睡请求皆不予采纳;到点后终端会接连三次沉缓鸣钟,以反色横幅与古典铭文循环催醒,直至您亲自按下回车键确认清醒方才止歇。
|
|
61
|
+
|
|
62
|
+
**问:若我一时匆忙,输入了 `02:00`、`1430`、`下午2点半`、`一个钟头后`,或是把时间与事务名目写反了,会被退回重填吗?**
|
|
63
|
+
|
|
64
|
+
答:自然不会。严于律己固然是本分,但在输入格式上苛责使用者却非君子所为。全角标点、紧凑数字、口语时刻、相对时长乃至命令行参数顺序颠倒,时计皆会在幕后悄然归位;至于 `25:30` 这类深夜跨日时制或 `01:75` 的分钟进位,也会在替您折算妥当的同时附上一句温和提醒。
|
|
65
|
+
|
|
66
|
+
**问:候场期间轮播的那些泰西名言,为何与外间坊刻的通行译本大相径庭?**
|
|
67
|
+
|
|
68
|
+
答:阁下眼力过人。候场轮播所录的四十八则箴言,悉数出自寒舍地下书库秘藏的宽政二年旧钞善本。外间流通的近代印本历经书商删削与俗人转抄,往往遗落了关乎提前整备的紧要下半截。您既可在候场期间按下 `L` 键锁定品读、按下 `C` 键当场展阅对应批注,亦可直接运行 `uvx tohsaka --codex`(也可附带 `目录` 或 `旧札`)启封那只檀木旧函,用方向键逐页细读卷首题记、初代朱批、泰西原文以及同通行印本的墨批与考证对勘。
|
|
69
|
+
|
|
70
|
+
## Python API
|
|
71
|
+
|
|
72
|
+
```python
|
|
73
|
+
import tohsaka
|
|
74
|
+
|
|
75
|
+
# 1. 报时,读数恒定快 1 小时
|
|
76
|
+
print(tohsaka.chime()["announcement"])
|
|
77
|
+
|
|
78
|
+
# 2. 校准目标时间,02:00 将于 01:00 触发
|
|
79
|
+
plan = tohsaka.calibrate("02:00")
|
|
80
|
+
print(plan["trigger_at"], plan["buffer_progress"])
|
|
81
|
+
|
|
82
|
+
# 3. 定时回调
|
|
83
|
+
tohsaka.schedule("02:00", lambda p: print("距离目标时刻还有整整一小时。"))
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## License
|
|
87
|
+
|
|
88
|
+
MIT
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=77"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "tohsaka"
|
|
7
|
+
version = "1.0.0"
|
|
8
|
+
description = "Graceful time management utility that always triggers 60 minutes ahead of target deadlines."
|
|
9
|
+
readme = { file = "README.md", content-type = "text/markdown; charset=UTF-8" }
|
|
10
|
+
requires-python = ">=3.9"
|
|
11
|
+
license = "MIT"
|
|
12
|
+
license-files = ["LICENSE"]
|
|
13
|
+
keywords = ["tohsaka", "timer", "alarm", "schedule", "clock", "graceful"]
|
|
14
|
+
classifiers = [
|
|
15
|
+
"Programming Language :: Python :: 3",
|
|
16
|
+
"Operating System :: OS Independent",
|
|
17
|
+
]
|
|
18
|
+
|
|
19
|
+
[project.urls]
|
|
20
|
+
Homepage = "https://github.com/xh10032/kenageya"
|
|
21
|
+
Repository = "https://github.com/xh10032/kenageya"
|
|
22
|
+
Issues = "https://github.com/xh10032/kenageya/issues"
|
|
23
|
+
|
|
24
|
+
[project.scripts]
|
|
25
|
+
tohsaka = "tohsaka:main"
|
|
26
|
+
|
|
27
|
+
[tool.setuptools]
|
|
28
|
+
packages = ["tohsaka"]
|
tohsaka-1.0.0/setup.cfg
ADDED