FsToolkit.ErrorHandling.IcedTasks 4.16.0

FsToolkit.ErrorHandling

FsToolkit.ErrorHandling 是一个实用程序库，用于处理 F# 中的 Result 类型，并允许你进行清晰、简单且强大的错误处理。

该库提供如 map、bind、apply、traverse、sequence 等工具函数，以及计算表达式和前缀运算符来处理 Result<'a, 'b>、Result<'a option, 'b>、Async<Result<'a, 'b>>、Async<Result<'a option, 'b>>、和 Result<'a, 'b List>。

它受到了 Chessie 和 Cvdm.ErrorHandling（后者已被合并到 FsToolkit.ErrorHandling）的启发。

FsToolkit.ErrorHandling 旨在针对 .NET Standard 2.0 和 .NET Framework 4.6.1，并支持 Fable。

文档

文档可在 此处 获取。

额外资料

• 学习这种编程风格的主要资源是 面向铁路的编程
• 但是，结果并非万能，请参阅什么陷阱以及不应使用 Result 的地方。 为异常辩护：扔掉你的 Result

构建

GitHub Actions

NuGet

包名称	版本	预发布
FsToolkit.ErrorHandling
FsToolkit.ErrorHandling.TaskResult
FsToolkit.ErrorHandling.JobResult
FsToolkit.ErrorHandling.AsyncSeq
FsToolkit.ErrorHandling.IcedTasks

本地开发

Devcontainer

此仓库为VSCode配置了devcontainer。更多信息请参阅

• VSCode

本地设置

• .NET Core SDK
  • v6.x
  • v7.x

可选

要本地测试fable构建，您将需要

• Node
  • v18.0.0 或更高版本
  • 虽然不是必需的，但建议您使用 NVM 管理Node的多个版本
• Python
  • v3.10.0 或更高版本
  • 这对于Fable-Python是必需的

编译

> build.cmd <optional buildtarget> // on windows
$ ./build.sh  <optional buildtarget>// on unix

如果没有指定编译目标，默认目标是 DotnetPack，它将在dotnet上运行所有项目的测试并将项目打包成nuget包。有关其他值得注意的目标，请参见下文。

编译目标

• Clean - 将清理所有项目的 bin 和 obj 文件夹
• DotnetTest - 将运行 dotnet 项目的测试
• NpmTest - 将运行 fable-javascript 项目的测试
• PythonTest - 将运行 fable-python 项目的测试
• RunTests - 将运行 dotnet、fable-javascript 和 fable-python 项目的测试
• FormatCode - 将运行 fantomas 对代码库进行格式化

这不是一个详尽的列表。可以在 ./build/build.fs 文件中找到其他目标。

一个激励的例子

此登录流程的组成示例展示了如何使用这个库通过计算表达式和几个辅助函数，实现清晰、简单、强大的错误处理。 (这个库还有更多辅助函数和计算表达式以及中缀运算符；有关详细信息，请参阅文档)

// Given the following functions:
//   tryGetUser: string -> Async<User option>
//   isPwdValid: string -> User -> bool
//   authorize: User -> Async<Result<unit, AuthError>>
//   createAuthToken: User -> Result<AuthToken, TokenError>

type LoginError = InvalidUser | InvalidPwd | Unauthorized of AuthError | TokenErr of TokenError

let login (username: string) (password: string) : Async<Result<AuthToken, LoginError>> =
  asyncResult {
    // requireSome unwraps a Some value or gives the specified error if None
    let! user = username |> tryGetUser |> AsyncResult.requireSome InvalidUser

    // requireTrue gives the specified error if false
    do! user |> isPwdValid password |> Result.requireTrue InvalidPwd

    // Error value is wrapped/transformed (Unauthorized has signature AuthError -> LoginError)
    do! user |> authorize |> AsyncResult.mapError Unauthorized

    // Same as above, but synchronous, so we use the built-in mapError
    return! user |> createAuthToken |> Result.mapError TokenErr
  }

赞助商

<a href="https://www.ajira.tech"><img src="./Ajira-logo.png" alt="Ajira Technologies, India" width="200" /></a>