每天用 Jupyter 寫 5 分鐘的日記

有些人會遵循傳統，制定一年的計劃。不過，一年的時間很長，所以我以季節性的主題或軌跡來規劃。每個季度，我都會坐下來，看看即將到來的三個月的季節，並決定在這段時間裡我將努力做什麼。

對於我最新的主題，我決定要每天寫一篇日記。我喜歡有明確的承諾，所以我承諾每天寫 5 分鐘。我也喜歡有可觀察的承諾，哪怕只是對我而言，所以我把我的記錄放在 Git 里。

我決定在寫日記的過程中實現一些自動化，於是我使用了我最喜歡的自動化工具：Jupyter。Jupyter 有一個有趣的功能 ipywidgets，這是一套用於 Jupyter Notebooks、JupyterLab 和 IPython 內核的互動式 HTML 組件。

如果你想跟著本文的代碼走，請注意，讓你的 JupyterLab 實例支持組件可能有點複雜，請按照這些說明來進行設置。

導入 ipywidgets 模塊

首先，你需要導入一堆東西，比如 ipywidgets 和 Twisted。Twisted 模塊可以用來創建一個非同步時間計數器：

import twisted.internet.asyncioreactor
twisted.internet.asyncioreactor.install()
from twisted.internet import reactor, task
import ipywidgets, datetime, subprocess, functools, os

設置定時條目

用 Twisted 實現時間計數器是利用了 task.LoopingCall。然而，結束循環調用的唯一方法是用一個異常。倒計時時鐘總會停止，所以你需要一個自定義的異常來指示「一切正常；計數器結束」：

class DoneError(Exception):
    pass

現在你已經寫好了異常，你可以寫定時器了。第一步是創建一個 ipywidgets.Label 的文本標籤組件。循環使用 divmod 計算出分和秒，然後設置標籤的文本值：

def time_out_counter(reactor):
    label = ipywidgets.Label("Time left: 5:00")
    current_seconds = datetime.timedelta(minutes=5).total_seconds()
    def decrement(count):
        nonlocal current_seconds
        current_seconds -= count
        time_left = datetime.timedelta(seconds=max(current_seconds, 0))
        minutes, left = divmod(time_left, minute)
        seconds = int(left.total_seconds())
        label.value = f"Time left: {minutes}:{seconds:02}"
        if current_seconds < 0:
            raise DoneError("finished")
    minute = datetime.timedelta(minutes=1)
    call = task.LoopingCall.withCount(decrement)
    call.reactor = reactor
    d = call.start(1)
    d.addErrback(lambda f: f.trap(DoneError))
    return d, label

從 Jupyter 組件中保存文本

下一步是寫一些東西，將你輸入的文字保存到一個文件中，並提交到 Git。另外，由於你要寫 5 分鐘的日記，你需要一個能給你提供寫字區域的組件（滾動肯定是可以的，但一次能看到更多的文字就更好了）。

這就用到了組件 Textarea，這是一個你可以書寫的文本欄位，而 Output 則是用來給出反饋的。這一點很重要，因為 git push 可能會花點時間或失敗，這取決於網路。如果備份失敗，用反饋提醒用戶很重要：

def editor(fname):
    textarea = ipywidgets.Textarea(continuous_update=False)
    textarea.rows = 20
    output = ipywidgets.Output()
    runner = functools.partial(subprocess.run, capture_output=True, text=True, check=True)
    def save(_ignored):
        with output:
            with open(fname, "w") as fpout:
                fpout.write(textarea.value)
            print("Sending...", end='')
            try:
                runner(["git", "add", fname])
                runner(["git", "commit", "-m", f"updated {fname}"])
                runner(["git", "push"])
            except subprocess.CalledProcessError as exc:
                print("Could not send")
                print(exc.stdout)
                print(exc.stderr)
            else:
                 print("Done")
    textarea.observe(save, names="value")
    return textarea, output, save

continuous_update=False 是為了避免每個字元都保存一遍並發送至 Git。相反，只要脫離輸入焦點，它就會保存。這個函數也返回 save 函數，所以可以明確地調用它。

創建一個布局

最後，你可以使用 ipywidgets.VBox 把這些東西放在一起。這是一個包含一些組件並垂直顯示的東西。還有一些其他的方法來排列組件，但這足夠簡單：

def journal():
    date = str(datetime.date.today())
    title = f"Log: Startdate {date}"
    filename = os.path.join(f"{date}.txt")
    d, clock = time_out_counter(reactor)
    textarea, output, save = editor(filename)
    box = ipywidgets.VBox([
        ipywidgets.Label(title),
        textarea,
        clock,
        output
    ])
    d.addCallback(save)
    return box

biu！你已經定義了一個寫日記的函數了，所以是時候試試了。

journal()


你現在可以寫 5 分鐘了！

via: https://opensource.com/article/20/11/daily-journal-jupyter

作者：Moshe Zadka 選題：lujun9972 譯者：wxy 校對：wxy

本文由 LCTT 原創編譯，Linux中國 榮譽推出

本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive