swift-gen

swift-gen

Swift轻量级随机性生成和控制框架

Gen是一个Swift随机性API封装框架,提供可组合的接口来创建复杂的随机值生成器。它支持延迟生成和可控随机性,适用于开发和测试场景。该框架还包含多种操作符和辅助函数,方便开发者扩展随机性功能。

Gen随机性SwiftAPI可组合性Github开源项目

🎱 Gen

CI

可组合、可转换、可控制的随机性。

目录

动机

Swift的随机性API功能强大且易于使用。它允许我们从许多基本类型创建随机值,如布尔值和数字类型,并允许我们随机打乱数组和从集合中随机选取元素。

然而,它并不容易让我们扩展随机性API,也没有提供一个可组合的API,这本可以让我们从更简单的部分创建复杂类型的随机性。

Gen是Swift随机性API的一个轻量级封装,它使得构建任何类型值的自定义生成器变得容易。

示例

Gen的同名类型Gen负责生成随机值。大多数情况下,你会使用Gen内的静态变量来获取一个Gen值:

Gen.bool // Gen<Bool>

Gen不会立即生成随机值,而是描述了一个可以通过调用其run方法生成的随机值:

let myGen = Gen.bool // Gen<Bool> myGen.run() // true myGen.run() // true myGen.run() // false

Swift自带的每个随机函数在Gen上也有对应的静态函数:

Swift的APIGen的API
Int.random(in: 0...9)Gen.int(in: 0...9)
Double.random(in: 0...9)Gen.double(in: 0...9)
Bool.random()Gen.bool
[1, 2, 3].randomElement()Gen.element(of: [1, 2, 3])
[1, 2, 3].shuffled()Gen.shuffle([1, 2, 3])

将随机性封装在Gen类型中的强大之处在于我们可以使Gen类型可组合。例如,一个整数生成器可以通过简单应用map函数转换为数字字符串的生成器:

let digit = Gen.int(in: 0...9) // Gen<Int> let stringDigit = digit.map(String.init) // Gen<String> stringDigit.run() // "7" stringDigit.run() // "1" stringDigit.run() // "3"

这已经是Swift API本身没有提供的随机性形式。

Gen提供了许多用于生成新类型随机性的操作符,如mapflatMapzip,以及用于生成随机数组、集合、字典、字符串、分布等的辅助函数!例如,一个随机密码生成器只需几个操作符就可以实现。

// 使用随机字母和数字的生成器。 let password = Gen.letterOrNumber // 生成6个字符的字符串。 .string(of: .always(6)) // 生成3段这样的字符串。 .array(of: .always(3)) // 然后将它们连接起来。 .map { $0.joined(separator: "-") } password.run() // "9BiGYA-fmvsOf-VYDtDv" password.run() // "dS2MGr-FQSuC4-ZLEicl" password.run() // "YusZGF-HILrCo-rNGfCA"

这种组合方式使得生成任何类型的随机值变得简单。

// 使用`zip`组合生成器并构建结构。 let randomPoint = zip(.int(in: -10...10), .int(in: -10...10)) .map(CGPoint.init(x:y:)) // Gen<CGPoint>

但可组合性并不是Gen类型出色的唯一原因。通过延迟随机值的创建直到调用run方法,我们允许在需要确定性的情况下控制随机性,比如在测试中。run方法有一个重载版本,它接受一个RandomNumberGenerator值,这是Swift的协议,为其随机性API提供支持。默认情况下,它使用SystemRandomNumberGenerator,这是一个很好的随机性来源,但我们也可以提供一个可播种的"伪"随机数生成器,这样我们就可以在测试中得到可预测的结果:

var xoshiro = Xoshiro(seed: 0) Gen.int(in: 0...9).run(using: &xoshiro) // "1" Gen.int(in: 0...9).run(using: &xoshiro) // "0" Gen.int(in: 0...9).run(using: &xoshiro) // "4" xoshiro = Xoshiro(seed: 0) Gen.int(in: 0...9).run(using: &xoshiro) // "1" Gen.int(in: 0...9).run(using: &xoshiro) // "0" Gen.int(in: 0...9).run(using: &xoshiro) // "4"

这意味着在应用程序中利用随机性时,你不必牺牲可测试性。

关于使用Gen构建复杂随机性的更多示例,请参见我们关于创建Zalgo生成器的博客文章和我们关于创建生成艺术的两部分视频系列(第1部分第2部分)。

安装

如果你想在使用SwiftPM的项目中使用Gen,只需在Package.swift中添加一个dependencies子句即可:

dependencies: [ .package(url: "https://github.com/pointfreeco/swift-gen.git", from: "0.4.0") ]

想了解更多?

这些概念(以及更多)在Point-Free中得到了深入探讨,这是一个由Brandon WilliamsStephen Celis主持的探索函数式编程和Swift的视频系列。

该库的设计在以下Point-Free剧集中得到了探讨:

  • 第30集:可组合的随机性
  • 第31集:可解码的随机性:第1部分
  • 第32集:可解码的随机性:第2部分
  • 第47集:可预测的随机性:第1部分
  • 第48集:可预测的随机性:第2部分
  • 第49集:生成艺术:第1部分 🆓
  • 第50集:生成艺术:第2部分 🆓
<a href="https://www.pointfree.co/episodes/ep30-composable-randomness"> <img alt="视频海报图片" src="https://yellow-cdn.veclightyear.com/2b54e442/1f25776a-7d7c-488c-9ca1-56f605e9166e.jpeg" width="600"> </a>

许可证

所有模块均在MIT许可证下发布。详情请见LICENSE

编辑推荐精选

讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞��绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

TRELLIS

TRELLIS

用于可扩展和多功能 3D 生成的结构化 3D 潜在表示

TRELLIS 是一个专注于 3D 生成的项目,它利用结构化 3D 潜在表示技术,实现了可扩展且多功能的 3D 生成。项目提供了多种 3D 生成的方法和工具,包括文本到 3D、图像到 3D 等,并且支持多种输出格式,如 3D 高斯、辐射场和网格等。通过 TRELLIS,用户可以根据文本描述或图像输入快速生成高质量的 3D 资产,适用于游戏开发、动画制作、虚拟现实等多个领域。

下拉加载更多