居住者量化并跟踪命令行中的习惯。

它本质上通过简单跟踪我们每天注意到的习惯出现次数，将管理我们的习惯（无论是好是坏）的问题公开化，让我们看到。这些数据可以随时查看，并通过使用特定的数学概念（例如泊松近似）来提供一些可视化这些习惯的方法。

功能

• 使用click库进行CLI交互
• 通过sqlite3库的合作添加、删除、更新习惯
• 持久数据存储在本地机器上；您的数据是 您 的，可以独立使用
• 使用泊松概率处理您的数据（更多数学概念将陆续推出）
• 打印习惯的摘要信息

安装

pip安装居住者

或者，您也可以 克隆仓库，但所有交互都必须在仓库根目录下进行（下面解释了两种用法）。

待办事项

• 提供一个配置命令，允许配置居住者
• 美化列表命令的打印输出（rich看起来很漂亮！）
• 实现“撤销”功能，以将习惯记录恢复到之前的状态
• 引入更多适合处理数据考虑的数学概念

用法

如果您使用pip安装了habiter，只需在任何地方调用habiter即可开始。

如果您克隆了仓库，请在以下命令中使用它（假设您位于项目根目录，且'python3'是您的Python解释器）

python3 -m habiter.internal.run

➜  habiter -h
[habiter]  Last accessed: 15 Jan, 1505 1:21AM

Usage: habiter [OPTIONS] COMMAND [ARGS]...

  Quantifies and keeps tabs on unwanted habits you have developed over time.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  add     add new habit(s) into record
  list    list all habits on record
  remove  delete habit(s) from record
  reset   reset some habit(s) from record
  tally   increment the number of occurrences for some habit(s)

  For more information, visit the code repository at
  https://github.com/kemzeb/habiter.

在请求-h选项后，这是打印出来的内容（只输入habiter也行）。我们将分析上面找到的每个子命令及其任何可选参数。

tally子命令允许增加记录中存在的一个或多个习惯的出现的次数。它按天跟踪日常和总习惯出现次数（又称“计数”）。它持有以下选项

• -z, --zero用于通知habiter您当天对于某些习惯没有任何计数
• -n, --num用于提供特定日期某些习惯的出现次数（请注意这适用于您当前输入的所有习惯）

-z, --zero选项最初存在的原因是因为habiter不以守护进程的形式运行，习惯数据不能根据某些时间限制自动更新。您可以提供-n 0作为输入，这本质上是一样的，但由于您很可能在特定的一天对习惯没有任何计数，这变得过于繁琐。零选项只是简单地通知habiter，您提供的输入习惯应被视为今天的活跃。如果您之后进行计数，您不会遇到任何麻烦，但如果您再次尝试为此特定习惯使用此选项，您将退出并显示错误。

add子命令允许将一个或多个习惯添加到记录中。如果习惯已在记录中，则将退出并显示错误，但不会妨碍添加任何其他输入的习惯名称。

remove子命令允许从记录中删除一个或多个习惯。与add类似，记录中不存在的习惯将退出并显示错误，但不会妨碍删除任何其他输入的习惯名称。

reset子命令允许将记录中的一个或多个习惯重置到初始状态。记录的累计和日常计数、捕获的天数和其他信息将不再存在，但习惯将保留在记录中。

list子命令允许打印记录中所有现有的习惯。其功能可以使用以下选项扩展

• -l, --less用于仅列出记录中的习惯名称

以下提供了list命令的示例

➜  habiter list
Habit + Attributes                    Value
-------------------                   -----
[mirror-writing]
  | P(Occurrences >= 2 today):        91.717%
  | Today's daily tally:              15
  | Total tally:                      1452
  | # of days captured:               352
  | Last updated:                     0 day(s) ago
  | Date added:                       15 Jan, 1505 1:21AM

[sculpting]
  | P(Occurrences >= 2 today):        48.854%
  | Today's daily tally:              15
  | Total tally:                      578
  | # of days captured:               352
  | Last updated:                     0 day(s) ago
  | Date added:                       15 Jan, 1505 1:22AM

-------------------                   -----
[habiter]  Note: More data captured = increased statistical accuracy!

您也可以通过传递习惯名称来更加具体。例如

➜  habiter list mirror-writing
Habit + Attributes                    Value
-------------------                   -----
[mirror-writing]
  | P(Occurrences >= 2 today):        91.717%
  | Today's daily tally:              15
  | Total tally:                      1452
  | # of days captured:               352
  | Last updated:                     0 day(s) ago
  | Date added:                       15 Jan, 1505 1:21AM

-------------------                   -----
[habiter]  Note: More data captured = increased statistical accuracy!