<p align="center"> <img src="https://github.com/Textualize/toolong/assets/554369/07f286c9-ac8d-44cd-905a-062a26060821" alt="一只笑翠鸟坐在卷轴上" width="300" > </p>

Toolong

一个用于查看、跟踪、合并和搜索日志文件（以及JSONL）的终端应用程序。

<details> <summary> 🎬 查看单个文件 </summary>

 

<div align="center"> <video src="https://github.com/Textualize/tailless/assets/554369/a434d427-fa9a-44bf-bafb-1cfef32d65b9" width="400" /> </div> </details>

保持冷静并记录文件

查看 Calmcode.io上的Toolong 以获得对Toolong的平和介绍。

是什么？

<img width="40%" align="right" alt="2024-02-08 13:47:28的截图" src="https://github.com/Textualize/toolong/assets/554369/1595e8e0-f5bf-428b-9b84-f0b5c7f506a1">

• 实时跟踪日志文件。
• 对常见的Web服务器日志格式进行语法高亮显示。
• 打开几个GB大小的文件和打开一个小型文本文件一样快。
• 支持JSONL文件：每行都会美化打印。
• 自动打开.bz和.bz2文件。
• 通过自动检测时间戳合并日志文件。

为什么？

在我过去作为Web开发人员的生涯中，我花了很多时间处理日志，通常是通过ssh在Web服务器上进行。我会使用各种工具，但我分析日志的首选方法是直接在服务器上使用诸如tail、less和grep等*nix工具。尽管这些工具很有用，但使用它们并非没有摩擦。

我构建toolong是为了创造我当时想要的工具。它反应迅速，使用简单，并为你完成了大量的繁重工作。

截图

<table> <tr> <td> <img width="100%" alt="2024-02-08 13:47:28的截图" src="https://github.com/Textualize/toolong/assets/554369/1595e8e0-f5bf-428b-9b84-f0b5c7f506a1"> </td> <td> <img width="100%" alt="2024-02-08 13:48:04的截图" src="https://github.com/Textualize/toolong/assets/554369/c95f0cf4-426d-4d25-b270-eec0f4cfc86f"> </td> </tr> <tr> <td> <img width="100%" alt="2024-02-08 13:49:22的截图" src="https://github.com/Textualize/toolong/assets/554369/45e7509c-ffed-44cc-b3e6-f2a7a276bbe5"> </td> <td> <img width="100%" alt="2024-02-08 13:50:04的截图" src="https://github.com/Textualize/toolong/assets/554369/6840b626-539f-4ef9-88d9-25e0b96036b7"> </td> </tr> </table>

视频

<details> <summary> 🎬 合并多个（压缩）文件 </summary> &nbsp; <div align="center"> <video src="https://github.com/Textualize/tailless/assets/554369/efbbde11-bebf-44ff-8d2b-72a84b542b75" /> </div> </details> <details> <summary> 🎬 查看JSONL文件 </summary> &nbsp; <div align="center"> <video src="https://github.com/Textualize/tailless/assets/554369/38936600-34ee-4fe1-9fd3-b1581fc3fa37" /> </div> </details> <details> <summary> 🎬 实时跟踪文件 </summary> &nbsp; <div align="center"> <video src="https://github.com/Textualize/tailless/assets/554369/7eea6a0e-b30d-4a94-bb45-c5bff0e329ca" /> </div> </details>

如何使用？

目前最好使用pipx安装Toolong。

pipx install toolong

你也可以使用Pip安装Toolong：

pip install toolong

[!注意] 如果你使用pip，理想情况下应该创建一个虚拟环境以避免潜在的依赖冲突。

无论你如何安装Toolong，tl命令都会被添加到你的路径中：

tl

在不久的将来，将会有更多的安装方法，希望包括你喜欢的包管理器。

兼容性

Toolong适用于Linux、macOS和Windows。

打开文件

要用Toolong打开文件，将文件名作为参数添加到命令中：

tl mylogfile.log

如果添加多个文件名，它们将在标签页中打开。

添加--merge开关可以打开多个文件并将它们合并到一个视图中：

tl access.log* --merge

在应用程序中，按f1获取额外帮助。

管道

除了指定文件外，你还可以直接将数据通过管道传输到tl。 这意味着你可以跟踪来自其他进程的数据，而不一定是文件。 这里有一个将tree命令的输出通过管道传输到Toolong的例子：

tree / | tl

作者是谁？

这个家伙。一个不知怎么靠写终端应用程序维生的前Web开发者。

---

历史

如果你在Twitter上关注我，你可能看到我把这个应用称为Tailless，因为它最初是打算替代tail + less组合的。 我最终选择了"Toolong"这个名字，因为它更贴切，而且仍然保留了相同的首字母。

开发

Toolong v1.0.0有一个稳固的功能集，涵盖了我大部分的需求。 然而，像这样的工具还有大量可以添加的功能，我可能会在将来实现其中的一些。

如果你想讨论Toolong，可以在Textualize Discord服务器上找到我。

致谢

我感谢LogMerger项目，在构建Toolong时我参考了它（并借鉴了其正则表达式）。

替代方案

Toolong并不是第一个用于处理日志文件的TUI。lnav是一个更成熟的替代方案。