blob: ff0dfd1c3ff5a2de9c26d8c4162ab91961aa0f4e (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
[en]
help = """
[[b_blue]]**Usage**[[/]]: **rola** [-v | --version] [-h | --help] [-L | --lang *<LANG>*]
__ **OUTPUT CONTROL:**
__ [--silence | --quiet] [--no-error] [--no-result]
__ [--no-color] [--json | --json-pretty]
__ **LOGS:**
__ [-V | --verbose] [--log-time]
__ [--log-level _disable_ | [[gray]]_trace_[[/]] | [[b_cyan]]_debug_[[/]] | [[b_yellow]]_warn_[[/]] | [[b_red]]_error_[[/]]]
__ **CONTEXT:**
__ [--bucket-dir *<DIR>*] [--draft-dir *<DIR>*] [--dir *<CWD>*]
__ **BEHAVIOUR CONTROL:**
__ [[b_yellow]]**[-y | --yes]**[[/]] [[b_red]]**[-O | --overwrite]**[[/]] [--no-pager]
"""
[zh_CN]
help = """
[[b_blue]]**用法**[[/]]：**rola** [-v | --version] [-h | --help] [-L | --lang *<LANG>*]
__ **输出控制：**
__ [--silence | --quiet] [--no-error] [--no-result]
__ [--no-color] [--json | --json-pretty]
__ **日志：**
__ [-V | --verbose] [--log-time]
__ [--log-level _disable_ | [[gray]]_trace_[[/]] | [[b_cyan]]_debug_[[/]] | [[b_yellow]]_warn_[[/]] | [[b_red]]_error_[[/]]]
__ **上下文：**
__ [--bucket-dir *<DIR>*] [--draft-dir *<DIR>*] [--dir *<CWD>*]
__ **行为控制：**
__ [[b_yellow]]**[-y | --yes]**[[/]] [[b_red]]**[-O | --overwrite]**[[/]] [--no-pager]
"""
# 全局：
# --draft-dir 草稿路径
# --bucket-dir 桶路径
# --dir 路径
# -V --version
# -v --verbose
# -h --help
# -L --lang --language
# --json --json-pretty
# --no-color --no-pager
# --no-error --only-error
# --quiet / --silence
# -y / --yes
# --overwrite
# # 创建草稿，临时视图
# rola create --draft
# rola init --draft
# # 创建桶，存储库，远程真相
# rola create --bucket
# rola init --bucket
# # 仅 draft 中命令
# # 桶
# rola bucket origin --bind-to-url url
# rola bucket origin --delete / -D
# rola bucket origin --rename-to other
# rola bucket # 列出
# rola bucket origin # 显示元数据
# # 检查连接
# rola test-connection --url url
# rola test-connection --bucket origin
# # 信息同步
# rola update
# rola update --all
# # 视图
# rola view # 列出所有视图
# rola view THIS # 当前视图
# rola view origin/main # 主视图
# rola view --new other # 新建视图
# rola view --clone other # 克隆视图
# rola view --checkout-clone other # 新建视图并直接切换
# rola view --checkout-new other # 新建视图并直接切换
# rola view --checkout other # 切换
# rola view origin --rename-to other # 命名
# rola view --forget origin # 忘记视图
# rola view origin/main --track-to main # 跟踪
# rola view main --track-to origin/main # 跟踪
# rola view main --break-track # 断开跟踪
# rola view --show-track # 展示跟踪状态
# rola view main --show-track # 展示跟踪状态
# rola view main --up-track # 同步视图 上传 (只提醒使用--overwrite-up-track)
# rola view main --overwrite-up-track # 同步视图 上传
# rola view main --down-track # 同步视图 下载
# # 状态
# rola status --view main # 检查视图状态 （等效 rola view main）
# rola status # 检查草稿状态（如果在draft）
# rola status # 检查桶状态（如果在bucket）
# rola status --file ./file # 检查文件状态
# rola status --file . # 检查多个文件状态
# rola status --bucket origin # 检查远程桶状态 (等效 rola bucket origin)
# rola status --bucket-url url # 检查url状态 (等效 rola test-connection --url url)
# rola status --align task # 检查对齐状态 (等效 rola align task)
# rola status --align-task # 检查所有对齐状态 (等效 rola align)
# # 实际版控
# rola set-forward ./my.file --follow latest # 将文件总是追踪最新版本
# rola set-forward ./my.file --follow ver:16 # 锁定到16版本
# rola set-forward ./my.file --follow origin/main # 跟随某个view的版本
# rola track . # 跟踪文件
# 为每个文件判断：
# 在 forward 为 latest 时
# 1. 本地版本同步，且已修改：尝试上传（可能冲突）
# 2. 本地版本不同步，且未修改：下载
# 3. 本地版本不同步，且已修改：阻止！（使用 --overwrite 覆盖）
# 4. 在 3 的情况下，使用 --overwrite 覆盖本地（或显式使用 --down --overwrite）
# 5. 在 3 的情况下，使用 --up --overwrite 覆盖远程（强制提交）
# 在 forward 为 ver 时
# 1. 本地版本同步 ver，且已修改：阻止！（使用 --overwrite 覆盖）
# 2. 本地版本不同步 ver，且未修改：下载
# 3. 本地版本同步 ver，未修改，什么都不做
# 在 forward 为 view 时
# 1. 如果view中没有该文件，阻止！（使用 --allow-non-forward）
# 2. 如果view中没有该文件，且使用 --allow-non-forward：不做任何事
# 3. 如果view存在该文件，将view中该文件的版本视作ver，同（在 forward 为 ver 时）的行为
# 显式模式：
# --up --down 显式指定上传或下载，若状态不一，必须使用 --overwrite
# # 对齐
# rola align # 查看所有本地 view 和实际结构不一致的情况（移动、新增、丢失）
# rola align 移动项 --connect 丢失项
# rola align 丢失项 --connect 移动项 # 匹配为移动
# rola align 移动项 --confirm # 确认移动
# rola align 新增项 --confirm # 确认新增
# rola align 丢失项 --confirm # 确认丢失 (为删除)
# rola align --confirm-all # 全部确认（谨慎！）
# rola align 移动项 --break # 断开为丢失和新增
# rola align 项 # 查看项
# # view 之间操作 (--overwrite 覆写)
# rola send 文件 --to-view view # 将该文件发送到view（同当前view的位置）
# rola send 文件 --to-view view --path # 将文件发送到view（指定位置）
# rola send view:文件 --to-view ... # 使用指定view的文件
# rola send view:文件 --to-view THIS # 从其他view拉取文件到此处
# rola send bucket/view:文件 --to-view THIS # 从远程view拉取文件到此处
# # 直接 view-tree 操作（危险的修复行为）
# rola op-view-tree rm path # 删除某条路径记录
# rola op-view-tree add path --id 文件id # 新增某条路径记录
# rola op-view-tree set path --forward xx --id xx # 修改某条路径记录
# rola op-view-tree mv path ... path2 # 移动某条路径记录
# rola op-view-tree cp path ... path2 # 移动某条路径记录
# rola stack view1 view2 view3 ... --clone-into view4 (将view1 view2 view3的视图堆叠成一个视图，放置到view4)
# rola stack ... --into view4 (同上，但是会删除旧视图)
# rola op-idmap ls # 列出所有 id map
# rola op-idmap ls id # 列出关于该 id 的映射
# rola op-idmap ls --remote id # 反向查找：通过远程 id 查找本地 id
# rola op-idmap write 12 --to-remote 25 # 将 12 号 id 映射到 远程 id 25
# rola op-idmap clean 12 # 将 12 号 id 映射移除
# rola op-idmap clean --remote 12 # 将映射到远程12号id的本地id移除
# # 查询操作
# rola query bind-buckets
# rola query views
# rola query idmaps
# rola query objects
# # 视图查看
# rola ls # 等效别名 (rls)：展示当前目录的元数据（富有rola元数据的ls命令）
# rola tree # 等效别名 (rtree): 展示当前目录的树
# # GUI
# rola desktop --install # 安装 RorolalaVCS - Dashboard
# rola desktop # 启动 RorolalaVCS - Dashboard
# # 更新
# rola source show # 展示远程更新源
# rola source update-info # 更新远程信息
# rola source update # 更新rola
# rola source change 源 # 切换更新源
# rola source show-info # 查询更新信息
# # 交互式
# rola op-view-tree --shell-mode # 进入 REPL 直接使用 cd ls rm add set mv 操作 tree
|
