Kurukuru - 炫酷的终端旋转指示器库

Kurukuru - 炫酷的终端旋转指示器库

KurukuruTerminal Spinner for .NET platform项目地址:https://gitcode.com/gh_mirrors/ku/Kurukuru

项目介绍

Kurukuru 是一个专为.NET平台（包括.NET Framework、.NET Standard和.NET 5）设计的终端旋转指示器库。灵感来源于 cli-spinners、ora 和 CLISpinner，它为你的命令行应用增添了一抹生动的色彩。

项目技术分析

Kurukuru 的核心特性是能够自动识别Windows环境中的非Unicode代码页，并在不支持Unicode的终端中优雅地使用ASCII字符进行渲染。例如，在使用CP437或CP932等编码的环境下，库会默认切换到ASCII模式，保证视觉效果的一致性。

此外，当程序的输出被重定向时，如在持续集成(CI)环境中，Kurukuru将自动禁用旋转指示器，仅显示结果文本，这对于自动化脚本非常友好。

项目及技术应用场景

Kurukuru 可广泛用于以下场景：

1. 在命令行界面执行耗时操作时，提供可视化的进度反馈。
2. 配合CI/CD工具，展示构建或测试的状态。
3. 创建交互式的CLI工具，提升用户体验。

项目特点

1. 跨平台兼容: 支持.NET Framework、.NET Standard和.NET 5，可在多种平台上运行。
2. 智能适应: 自动检测Windows环境下是否支持Unicode，并调整显示策略。
3. 易于使用: 通过简单的API调用即可轻松添加旋转指示器，支持同步和异步操作。
4. 动态更新: 运行时可以更改指示器的文字描述，灵活响应任务状态变化。
5. 多样化的结果提示: 提供成功、失败、警告和信息等多种结果提示样式。

安装与使用

你可以通过NuGet包管理器或者.NET CLI轻松安装Kurukuru：

• 包管理器Console:

Install-Package Kurukuru

• .NET 命令:

dotnet add package Kurukuru

使用也非常简单，只需using Kurukuru;，然后调用Spinner.Start方法即可：

Spinner.Start("处理中...", () =>
{
    Thread.Sleep(1000 * 3);
    
    // 如果出现问题，抛出异常
    // throw new Exception("出错了！");
});

// 更多高级用法...

Kurukuru 让你的命令行应用更具互动性和吸引力，无论是在开发阶段还是部署过程中，都是不可多得的好帮手。立即尝试，体验更出色的终端操作反馈吧！

KurukuruTerminal Spinner for .NET platform项目地址:https://gitcode.com/gh_mirrors/ku/Kurukuru