log-ctrl 0.0.1__tar.gz → 0.0.4__tar.gz

{log_ctrl-0.0.1 → log_ctrl-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
-Name: log_ctrl
-Version: 0.0.1
+Name: log-ctrl
+Version: 0.0.4
 Summary: gRPC server and proxy for reading x_logger rotating log files by device class.
 Author-email: Kengo NAKADA <kengo.nakada@email.com>
 License:                                  Apache License
@@ -230,16 +230,15 @@ Dynamic: license-file
 
 # log_ctrl
 
-[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.en.md)
-[![ja](https://img.shields.io/badge/lang-ja-yellow.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.md)
+[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.md)
+[![ja](https://img.shields.io/badge/lang-ja-yellow.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.ja.md)
 
-`log_ctrl`
-は、指定したログディレクトリに保存されているログファイルを、`grpc_frame`
-を使ってネットワーク越しに参照するためのパッケージです。
+`log_ctrl` is a package for accessing log files stored in a specified
+log directory over a network using `grpc_frame`.
 
-ログを書き込む側の DeviceServer やアプリケーションにはログ取得 RPC
-を追加しません。`log_ctrl` は既存のログファイルを read-only
-で参照する独立した gRPC サーバーとして動作します。
+It does not add log retrieval RPCs to the DeviceServer or application
+that writes the logs. `log_ctrl` runs as an independent, read-only gRPC
+server that accesses existing log files.
 
 ``` text
 application / DeviceServer
@@ -263,9 +262,9 @@ C:\opt\ese774\log
 DeviceProxy("log", ...)
 ```
 
-## ログ名
+## Log names
 
-`log_ctrl` では、`.log` より前の部分を `log_name` と呼びます。
+In `log_ctrl`, the part before `.log` is called the `log_name`.
 
 ``` text
 cobotta4_server.log
@@ -273,47 +272,52 @@ cobotta4_server.log
    log_name
 ```
 
-ローテーション済みログは次の形式です。
+Rotated log files use the following format:
 
 ``` text
 <log_name>.log.YYYY-MM-DD
 ```
 
-`log_name` は DeviceServer
-名やデバイスクラス名と一致する必要はありません。`log_ctrl`
-はファイル名として存在する `log_name` をそのまま扱います。
+The `log_name` does not need to match the DeviceServer name or device
+class name. `log_ctrl` uses the `log_name` exactly as it appears in the
+filename.
 
-## 主な機能
+## Main features
 
-- `log_names()` : 実在するログファイルから `log_name` 一覧を取得
-- `dates(log_name)` : 指定した `log_name`
-  のローテーション日付一覧を取得
-- `exists(log_name, date=None)` : 現在ログまたは指定日ログの存在確認
-- `tail(log_name, lines=100, date=None)` : ログ末尾を文字列で取得
-- `raw_files()` : ログディレクトリ以下の全ファイルを相対パスで列挙
-- `read(log_name, date=None)` : ログファイル本体を `bytes` で取得
-- `read_raw(relative_path)` : `raw_files()` で確認した任意ファイルを
-  `bytes` で取得
+- `log_names()`: Get the list of `log_name` values from existing log
+  files.
+- `dates(log_name)`: Get the list of rotation dates for the specified
+  `log_name`.
+- `exists(log_name, date=None)`: Check whether the current log or a
+  log for a specified date exists.
+- `tail(log_name, lines=100, date=None)`: Get the end of a log as a
+  string.
+- `raw_files()`: List all files under the log directory as relative
+  paths.
+- `read(log_name, date=None)`: Read a log file as `bytes`.
+- `read_raw(relative_path)`: Read an arbitrary file confirmed by
+  `raw_files()` as `bytes`.
 
-大きなログファイルは `grpc_frame` の `StreamCall`
-を使ってチャンク転送します。利用側ではストリーム処理を直接扱う必要はなく、`read()`
-/ `read_raw()` が受信したチャンクを結合して `bytes` として返します。
+Large log files are transferred in chunks using `grpc_frame`
+`StreamCall`. Client-side code does not need to handle the stream
+directly; `read()` and `read_raw()` join the received chunks and return
+them as `bytes`.
 
-## インストール
+## Installation
 
-`grpc_frame` を利用可能な環境でインストールします。
+Install in an environment where `grpc_frame` is available.
 
 ``` bash
 python -m pip install .
 ```
 
-開発時は次のように editable install できます。
+For development, use an editable install:
 
 ``` bash
 python -m pip install -e .
 ```
 
-## LogServer の起動
+## Starting LogServer
 
 ``` python
 from log_ctrl.server_grpc import log_grpc_server
@@ -329,12 +333,12 @@ log_grpc_server(
 )
 ```
 
-`logger` を省略した場合は標準の `logging` が使用されます。既存の logger
-を使用する場合は `logger=` で渡せます。
+If `logger` is omitted, the standard `logging` module is used. To use an
+existing logger, pass it with `logger=`.
 
-## クライアント
+## Client
 
-`grpc_frame` の透過クライアントとして `DeviceProxy` を使用します。
+Use `DeviceProxy` as the transparent `grpc_frame` client.
 
 ``` python
 from log_ctrl.server_grpc import DeviceProxy
@@ -364,9 +368,10 @@ finally:
     client.close()
 ```
 
-`log_names()` で返される名前は、現在の `<log_name>.log`
-が存在する名前だけとは限りません。ローテーション済みファイルだけが残っている場合も一覧に含まれます。現在ログを読む前に必要に応じて
-`exists(log_name)` を確認してください。
+The names returned by `log_names()` are not limited to names for which a
+current `<log_name>.log` file exists. A name is also included when only
+rotated log files remain. Check `exists(log_name)` as needed before
+reading the current log.
 
 ## API
 
@@ -388,20 +393,19 @@ client.read(log_name, date="2026-04-06")
 client.read_raw("cobotta4_server.log.2026-04-06")
 ```
 
-`read()` と `read_raw()` の戻り値は `bytes`
-です。ログを文字列として扱う場合は、使用している文字コードに合わせてクライアント側で
-decode します。
+`read()` and `read_raw()` return `bytes`. To handle a log as text,
+decode it on the client using the appropriate character encoding.
 
 ``` python
 text = client.read(log_name).decode("utf-8")
 ```
 
-`tail()` はサーバー側で設定された `encoding` を使って decode され、`str`
-を返します。
+`tail()` is decoded on the server using the configured `encoding` and
+returns `str`.
 
-## ドキュメント
+## Documentation
 
-Sphinx 用文書は `docs/` にあります。
+Sphinx documentation is available under `docs/`.
 
 - `docs/index.md`
 - `docs/quickstart.md`
@@ -411,4 +415,4 @@ Sphinx 用文書は `docs/` にあります。
 
 ## License
 
-`LICENSE` を参照してください。
+See `LICENSE`.

log_ctrl-0.0.4/README.md

@@ -0,0 +1,188 @@
+# log_ctrl
+
+[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.md)
+[![ja](https://img.shields.io/badge/lang-ja-yellow.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.ja.md)
+
+`log_ctrl` is a package for accessing log files stored in a specified
+log directory over a network using `grpc_frame`.
+
+It does not add log retrieval RPCs to the DeviceServer or application
+that writes the logs. `log_ctrl` runs as an independent, read-only gRPC
+server that accesses existing log files.
+
+``` text
+application / DeviceServer
+        │
+        │ write
+        ▼
+C:\opt\ese774\log
+├── cobotta4_server.log
+├── cobotta4_server.log.2026-04-06
+├── cobotta4_server2.log
+└── cobotta4_server2.log.2026-06-16
+        ▲
+        │ read only
+        │
+     LogCtrl
+        │
+        ▼
+ log gRPC server
+        │
+        ▼
+DeviceProxy("log", ...)
+```
+
+## Log names
+
+In `log_ctrl`, the part before `.log` is called the `log_name`.
+
+``` text
+cobotta4_server.log
+^^^^^^^^^^^^^^^
+   log_name
+```
+
+Rotated log files use the following format:
+
+``` text
+<log_name>.log.YYYY-MM-DD
+```
+
+The `log_name` does not need to match the DeviceServer name or device
+class name. `log_ctrl` uses the `log_name` exactly as it appears in the
+filename.
+
+## Main features
+
+- `log_names()`: Get the list of `log_name` values from existing log
+  files.
+- `dates(log_name)`: Get the list of rotation dates for the specified
+  `log_name`.
+- `exists(log_name, date=None)`: Check whether the current log or a
+  log for a specified date exists.
+- `tail(log_name, lines=100, date=None)`: Get the end of a log as a
+  string.
+- `raw_files()`: List all files under the log directory as relative
+  paths.
+- `read(log_name, date=None)`: Read a log file as `bytes`.
+- `read_raw(relative_path)`: Read an arbitrary file confirmed by
+  `raw_files()` as `bytes`.
+
+Large log files are transferred in chunks using `grpc_frame`
+`StreamCall`. Client-side code does not need to handle the stream
+directly; `read()` and `read_raw()` join the received chunks and return
+them as `bytes`.
+
+## Installation
+
+Install in an environment where `grpc_frame` is available.
+
+``` bash
+python -m pip install .
+```
+
+For development, use an editable install:
+
+``` bash
+python -m pip install -e .
+```
+
+## Starting LogServer
+
+``` python
+from log_ctrl.server_grpc import log_grpc_server
+
+GRPC_HOST = "0.0.0.0"
+GRPC_PORT = 50060
+LOG_DIR = r"C:\opt\ese774\log"
+
+log_grpc_server(
+    grpc_host=GRPC_HOST,
+    grpc_port=GRPC_PORT,
+    log_dir=LOG_DIR,
+)
+```
+
+If `logger` is omitted, the standard `logging` module is used. To use an
+existing logger, pass it with `logger=`.
+
+## Client
+
+Use `DeviceProxy` as the transparent `grpc_frame` client.
+
+``` python
+from log_ctrl.server_grpc import DeviceProxy
+
+client = DeviceProxy(
+    "log",
+    server_ip="127.0.0.1",
+    server_port=50060,
+    set_timeout_sec=10.0,
+    async_mode=False,
+)
+
+try:
+    log_names = client.log_names()
+    print(log_names)
+
+    if len(log_names) > 0:
+        log_name = log_names[0]
+
+        print(client.dates(log_name))
+
+        if client.exists(log_name):
+            data = client.read(log_name)
+            print(len(data))
+
+finally:
+    client.close()
+```
+
+The names returned by `log_names()` are not limited to names for which a
+current `<log_name>.log` file exists. A name is also included when only
+rotated log files remain. Check `exists(log_name)` as needed before
+reading the current log.
+
+## API
+
+``` python
+client.log_names()
+client.dates(log_name)
+
+client.exists(log_name)
+client.exists(log_name, date="2026-04-06")
+
+client.tail(log_name, lines=100)
+client.tail(log_name, lines=100, date="2026-04-06")
+
+client.raw_files()
+
+client.read(log_name)
+client.read(log_name, date="2026-04-06")
+
+client.read_raw("cobotta4_server.log.2026-04-06")
+```
+
+`read()` and `read_raw()` return `bytes`. To handle a log as text,
+decode it on the client using the appropriate character encoding.
+
+``` python
+text = client.read(log_name).decode("utf-8")
+```
+
+`tail()` is decoded on the server using the configured `encoding` and
+returns `str`.
+
+## Documentation
+
+Sphinx documentation is available under `docs/`.
+
+- `docs/index.md`
+- `docs/quickstart.md`
+- `docs/usage.md`
+- `docs/rotation.md`
+- `docs/architecture.md`
+
+## License
+
+See `LICENSE`.

{log_ctrl-0.0.1 → log_ctrl-0.0.4}/pyproject.toml

@@ -3,12 +3,14 @@ requires = ["setuptools>=40.8"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "log_ctrl"
-version = "0.0.1"
+name = "log-ctrl"
+version = "0.0.4"
+
 description = "gRPC server and proxy for reading x_logger rotating log files by device class."
 readme = "README.md"
 requires-python = ">=3.6"
 license = { file = "LICENSE" }
+
 authors = [
     { name = "Kengo NAKADA", email = "kengo.nakada@email.com" }
 ]

{log_ctrl-0.0.1 → log_ctrl-0.0.4}/src/log_ctrl.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
-Name: log_ctrl
-Version: 0.0.1
+Name: log-ctrl
+Version: 0.0.4
 Summary: gRPC server and proxy for reading x_logger rotating log files by device class.
 Author-email: Kengo NAKADA <kengo.nakada@email.com>
 License:                                  Apache License
@@ -230,16 +230,15 @@ Dynamic: license-file
 
 # log_ctrl
 
-[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.en.md)
-[![ja](https://img.shields.io/badge/lang-ja-yellow.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.md)
+[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.md)
+[![ja](https://img.shields.io/badge/lang-ja-yellow.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.ja.md)
 
-`log_ctrl`
-は、指定したログディレクトリに保存されているログファイルを、`grpc_frame`
-を使ってネットワーク越しに参照するためのパッケージです。
+`log_ctrl` is a package for accessing log files stored in a specified
+log directory over a network using `grpc_frame`.
 
-ログを書き込む側の DeviceServer やアプリケーションにはログ取得 RPC
-を追加しません。`log_ctrl` は既存のログファイルを read-only
-で参照する独立した gRPC サーバーとして動作します。
+It does not add log retrieval RPCs to the DeviceServer or application
+that writes the logs. `log_ctrl` runs as an independent, read-only gRPC
+server that accesses existing log files.
 
 ``` text
 application / DeviceServer
@@ -263,9 +262,9 @@ C:\opt\ese774\log
 DeviceProxy("log", ...)
 ```
 
-## ログ名
+## Log names
 
-`log_ctrl` では、`.log` より前の部分を `log_name` と呼びます。
+In `log_ctrl`, the part before `.log` is called the `log_name`.
 
 ``` text
 cobotta4_server.log
@@ -273,47 +272,52 @@ cobotta4_server.log
    log_name
 ```
 
-ローテーション済みログは次の形式です。
+Rotated log files use the following format:
 
 ``` text
 <log_name>.log.YYYY-MM-DD
 ```
 
-`log_name` は DeviceServer
-名やデバイスクラス名と一致する必要はありません。`log_ctrl`
-はファイル名として存在する `log_name` をそのまま扱います。
+The `log_name` does not need to match the DeviceServer name or device
+class name. `log_ctrl` uses the `log_name` exactly as it appears in the
+filename.
 
-## 主な機能
+## Main features
 
-- `log_names()` : 実在するログファイルから `log_name` 一覧を取得
-- `dates(log_name)` : 指定した `log_name`
-  のローテーション日付一覧を取得
-- `exists(log_name, date=None)` : 現在ログまたは指定日ログの存在確認
-- `tail(log_name, lines=100, date=None)` : ログ末尾を文字列で取得
-- `raw_files()` : ログディレクトリ以下の全ファイルを相対パスで列挙
-- `read(log_name, date=None)` : ログファイル本体を `bytes` で取得
-- `read_raw(relative_path)` : `raw_files()` で確認した任意ファイルを
-  `bytes` で取得
+- `log_names()`: Get the list of `log_name` values from existing log
+  files.
+- `dates(log_name)`: Get the list of rotation dates for the specified
+  `log_name`.
+- `exists(log_name, date=None)`: Check whether the current log or a
+  log for a specified date exists.
+- `tail(log_name, lines=100, date=None)`: Get the end of a log as a
+  string.
+- `raw_files()`: List all files under the log directory as relative
+  paths.
+- `read(log_name, date=None)`: Read a log file as `bytes`.
+- `read_raw(relative_path)`: Read an arbitrary file confirmed by
+  `raw_files()` as `bytes`.
 
-大きなログファイルは `grpc_frame` の `StreamCall`
-を使ってチャンク転送します。利用側ではストリーム処理を直接扱う必要はなく、`read()`
-/ `read_raw()` が受信したチャンクを結合して `bytes` として返します。
+Large log files are transferred in chunks using `grpc_frame`
+`StreamCall`. Client-side code does not need to handle the stream
+directly; `read()` and `read_raw()` join the received chunks and return
+them as `bytes`.
 
-## インストール
+## Installation
 
-`grpc_frame` を利用可能な環境でインストールします。
+Install in an environment where `grpc_frame` is available.
 
 ``` bash
 python -m pip install .
 ```
 
-開発時は次のように editable install できます。
+For development, use an editable install:
 
 ``` bash
 python -m pip install -e .
 ```
 
-## LogServer の起動
+## Starting LogServer
 
 ``` python
 from log_ctrl.server_grpc import log_grpc_server
@@ -329,12 +333,12 @@ log_grpc_server(
 )
 ```
 
-`logger` を省略した場合は標準の `logging` が使用されます。既存の logger
-を使用する場合は `logger=` で渡せます。
+If `logger` is omitted, the standard `logging` module is used. To use an
+existing logger, pass it with `logger=`.
 
-## クライアント
+## Client
 
-`grpc_frame` の透過クライアントとして `DeviceProxy` を使用します。
+Use `DeviceProxy` as the transparent `grpc_frame` client.
 
 ``` python
 from log_ctrl.server_grpc import DeviceProxy
@@ -364,9 +368,10 @@ finally:
     client.close()
 ```
 
-`log_names()` で返される名前は、現在の `<log_name>.log`
-が存在する名前だけとは限りません。ローテーション済みファイルだけが残っている場合も一覧に含まれます。現在ログを読む前に必要に応じて
-`exists(log_name)` を確認してください。
+The names returned by `log_names()` are not limited to names for which a
+current `<log_name>.log` file exists. A name is also included when only
+rotated log files remain. Check `exists(log_name)` as needed before
+reading the current log.
 
 ## API
 
@@ -388,20 +393,19 @@ client.read(log_name, date="2026-04-06")
 client.read_raw("cobotta4_server.log.2026-04-06")
 ```
 
-`read()` と `read_raw()` の戻り値は `bytes`
-です。ログを文字列として扱う場合は、使用している文字コードに合わせてクライアント側で
-decode します。
+`read()` and `read_raw()` return `bytes`. To handle a log as text,
+decode it on the client using the appropriate character encoding.
 
 ``` python
 text = client.read(log_name).decode("utf-8")
 ```
 
-`tail()` はサーバー側で設定された `encoding` を使って decode され、`str`
-を返します。
+`tail()` is decoded on the server using the configured `encoding` and
+returns `str`.
 
-## ドキュメント
+## Documentation
 
-Sphinx 用文書は `docs/` にあります。
+Sphinx documentation is available under `docs/`.
 
 - `docs/index.md`
 - `docs/quickstart.md`
@@ -411,4 +415,4 @@ Sphinx 用文書は `docs/` にあります。
 
 ## License
 
-`LICENSE` を参照してください。
+See `LICENSE`.

log_ctrl-0.0.1/README.md

@@ -1,184 +0,0 @@
-# log_ctrl
-
-[![en](https://img.shields.io/badge/lang-en-red.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.en.md)
-[![ja](https://img.shields.io/badge/lang-ja-yellow.svg)](https://github.com/ohara-lab-su/log_ctrl/blob/main/README.md)
-
-`log_ctrl`
-は、指定したログディレクトリに保存されているログファイルを、`grpc_frame`
-を使ってネットワーク越しに参照するためのパッケージです。
-
-ログを書き込む側の DeviceServer やアプリケーションにはログ取得 RPC
-を追加しません。`log_ctrl` は既存のログファイルを read-only
-で参照する独立した gRPC サーバーとして動作します。
-
-``` text
-application / DeviceServer
-        │
-        │ write
-        ▼
-C:\opt\ese774\log
-├── cobotta4_server.log
-├── cobotta4_server.log.2026-04-06
-├── cobotta4_server2.log
-└── cobotta4_server2.log.2026-06-16
-        ▲
-        │ read only
-        │
-     LogCtrl
-        │
-        ▼
- log gRPC server
-        │
-        ▼
-DeviceProxy("log", ...)
-```
-
-## ログ名
-
-`log_ctrl` では、`.log` より前の部分を `log_name` と呼びます。
-
-``` text
-cobotta4_server.log
-^^^^^^^^^^^^^^^
-   log_name
-```
-
-ローテーション済みログは次の形式です。
-
-``` text
-<log_name>.log.YYYY-MM-DD
-```
-
-`log_name` は DeviceServer
-名やデバイスクラス名と一致する必要はありません。`log_ctrl`
-はファイル名として存在する `log_name` をそのまま扱います。
-
-## 主な機能
-
-- `log_names()` : 実在するログファイルから `log_name` 一覧を取得
-- `dates(log_name)` : 指定した `log_name`
-  のローテーション日付一覧を取得
-- `exists(log_name, date=None)` : 現在ログまたは指定日ログの存在確認
-- `tail(log_name, lines=100, date=None)` : ログ末尾を文字列で取得
-- `raw_files()` : ログディレクトリ以下の全ファイルを相対パスで列挙
-- `read(log_name, date=None)` : ログファイル本体を `bytes` で取得
-- `read_raw(relative_path)` : `raw_files()` で確認した任意ファイルを
-  `bytes` で取得
-
-大きなログファイルは `grpc_frame` の `StreamCall`
-を使ってチャンク転送します。利用側ではストリーム処理を直接扱う必要はなく、`read()`
-/ `read_raw()` が受信したチャンクを結合して `bytes` として返します。
-
-## インストール
-
-`grpc_frame` を利用可能な環境でインストールします。
-
-``` bash
-python -m pip install .
-```
-
-開発時は次のように editable install できます。
-
-``` bash
-python -m pip install -e .
-```
-
-## LogServer の起動
-
-``` python
-from log_ctrl.server_grpc import log_grpc_server
-
-GRPC_HOST = "0.0.0.0"
-GRPC_PORT = 50060
-LOG_DIR = r"C:\opt\ese774\log"
-
-log_grpc_server(
-    grpc_host=GRPC_HOST,
-    grpc_port=GRPC_PORT,
-    log_dir=LOG_DIR,
-)
-```
-
-`logger` を省略した場合は標準の `logging` が使用されます。既存の logger
-を使用する場合は `logger=` で渡せます。
-
-## クライアント
-
-`grpc_frame` の透過クライアントとして `DeviceProxy` を使用します。
-
-``` python
-from log_ctrl.server_grpc import DeviceProxy
-
-client = DeviceProxy(
-    "log",
-    server_ip="127.0.0.1",
-    server_port=50060,
-    set_timeout_sec=10.0,
-    async_mode=False,
-)
-
-try:
-    log_names = client.log_names()
-    print(log_names)
-
-    if len(log_names) > 0:
-        log_name = log_names[0]
-
-        print(client.dates(log_name))
-
-        if client.exists(log_name):
-            data = client.read(log_name)
-            print(len(data))
-
-finally:
-    client.close()
-```
-
-`log_names()` で返される名前は、現在の `<log_name>.log`
-が存在する名前だけとは限りません。ローテーション済みファイルだけが残っている場合も一覧に含まれます。現在ログを読む前に必要に応じて
-`exists(log_name)` を確認してください。
-
-## API
-
-``` python
-client.log_names()
-client.dates(log_name)
-
-client.exists(log_name)
-client.exists(log_name, date="2026-04-06")
-
-client.tail(log_name, lines=100)
-client.tail(log_name, lines=100, date="2026-04-06")
-
-client.raw_files()
-
-client.read(log_name)
-client.read(log_name, date="2026-04-06")
-
-client.read_raw("cobotta4_server.log.2026-04-06")
-```
-
-`read()` と `read_raw()` の戻り値は `bytes`
-です。ログを文字列として扱う場合は、使用している文字コードに合わせてクライアント側で
-decode します。
-
-``` python
-text = client.read(log_name).decode("utf-8")
-```
-
-`tail()` はサーバー側で設定された `encoding` を使って decode され、`str`
-を返します。
-
-## ドキュメント
-
-Sphinx 用文書は `docs/` にあります。
-
-- `docs/index.md`
-- `docs/quickstart.md`
-- `docs/usage.md`
-- `docs/rotation.md`
-- `docs/architecture.md`
-
-## License
-
-`LICENSE` を参照してください。