BowOptics 0.8.0

BowOptics 0.8.0

×

由以下人员维护：TomásRuizLópez，Miguel Ángel Díaz，juancazalla。

BowOptics 0.8.0

  • 由
  • Bow 作者

Bow 是一个 Swift 键盘函数编程的多平台库。

文档

所有文档和 API 参考都发布在我们的网站上。一些链接到库的关键方面：

模块

Bow 被分割成多个模块，可以独立使用。这些模块包括：

  • Bow：核心库。包含高阶类型仿真、函数操作工具、类型类、数据类型、单子变换以及原始类型的实例。
  • BowOptics：模块，用于与不同的光学交互。
  • BowRecursionSchemes：模块，用于与递归方案交互。
  • BowFree：模块，用于与自由单子交互。
  • BowGeneric：模块，用于与泛型数据类型交互。
  • BowEffects：模块，用于与效应交互。
  • BowRx：模块，提供与 RxSwift 的集成。

还有一些用于测试的模块：

  • BowLaws：核心模块中类型类的定律。
  • BowOpticsLaws：光学的定律。
  • BowEffectsLaws：效应的定律。
  • BowGenerators：核心模块中数据类型的基于属性的测试生成器。
  • BowFreeGenerators：BowFree 中数据类型的基于属性的测试生成器。
  • BowEffectsGenerators：BowEffects 中数据类型的基于属性的测试生成器。
  • BowRxGenerators：BowRx 中数据类型的基于属性的测试生成器。

Bow 可以通过 Swift Package Manager、CocoaPods 和 Carthage 使用。

Swift 包管理器

从Xcode 11开始，您可以使用IDE中的集成功能以及Swift Package Manager将依赖项引入项目。您只需要提供仓库URL：https://github.com/bow-swift/bow.git。对于更早版本的Xcode，创建一个类似下面的Package.swift文件，并按需使用依赖项。

// swift-tools-version:5.0

import PackageDescription

let package = Package(
    name: "BowTestProject",
    dependencies: [
        .package(url: "https://github.com/bow-swift/bow.git", from: "{version}")
    ],
    targets: [
        .target(name: "BowTestProject",
                dependencies: [
                    "Bow",
                    "BowOptics",
                    "BowRecursionSchemes",
                    "BowFree",
                    "BowGeneric",
                    "BowEffects",
                    "BowRx"]),
        .testTarget(name: "BowTestProjectTests",
                    dependencies: [
                        // Type class laws
                        "BowLaws",
                        "BowOpticsLaws",
                        "BowEffectsLaws",

                        // Generators for PBT with SwiftCheck
                        "BowGenerators",
                        "BowFreeGenerators",
                        "BowEffectsGenerators",
                        "BowRxGenerators"])
    ]
)

要构建它，只需运行：

$ swift build

CocoaPods

您可以将每个Bow模块作为单独的pod使用。您可以在方便的时候将这些行添加到您的Podfile中

pod "Bow",                 "~> {version}"
pod "BowOptics",           "~> {version}"
pod "BowRecursionSchemes", "~> {version}"
pod "BowFree",             "~> {version}"
pod "BowGeneric",          "~> {version}"
pod "BowEffects",          "~> {version}"
pod "BowRx",               "~> {version}"

测试法则

pod "BowLaws",        "~> {version}"
pod "BowOpticsLaws",  "~> {version}"
pod "BowEffectsLaws", "~> {version}"

使用SwiftCheck的属性测试生成器

pod "BowGenerators",              "~> {version}"
pod "BowFreeGenerators",          "~> {version}"
pod "BowEffectsGenerators",       "~> {version}"
pod "BowRxGenerators",            "~> {version}"

Carthage

Carthage将下载整个Bow项目，但将为每个您希望单独使用的模块编译单个框架。添加此行到您的Cartfile

github "bow-swift/Bow" ~> {version}

贡献

如果您想为这个库做出贡献，您可以检查问题以查看一些待完成的任务。

如何运行项目

在Xcode 11（或更高版本）中打开Bow.xcodeproj，即可开始使用。Bow使用Swift Package Manager来处理其依赖项。

如何运行文档项目

  • 转到contents/Documentation目录。
  • 运行pod install以获取所有依赖项。
  • 打开Documentation.xcworkspace并运行项目。

有关更多信息，请参阅我们的贡献指南。

如何创建新版本

您可以通过运行 bundle exec fastlane release version_number: 来创建新版本。例如，bundle exec fastlane release version_number: 0.7.0。

以下步骤将被执行

  • 更新 *.podspec 文件中的 version。
  • 在 CHANGELOG 文件中添加消息并创建标签。
  • 推送 podspec 文件并使它们公开可用。

协议

Copyright (C) 2018-2020 The Bow Authors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://apache.ac.cn/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.