{"id":1138,"url":"https://github.com/bow-swift/bow","last_synced_at":"2025-10-21T10:54:00.594Z","repository":{"id":30245935,"uuid":"124252124","full_name":"bow-swift/bow","owner":"bow-swift","description":"🏹 Bow is a cross-platform library for Typed Functional Programming in Swift","archived":false,"fork":false,"pushed_at":"2022-10-09T21:51:49.000Z","size":761278,"stargazers_count":647,"open_issues_count":17,"forks_count":32,"subscribers_count":20,"default_branch":"master","last_synced_at":"2024-11-19T02:16:49.275Z","etag":null,"topics":["bow","carthage","category-theory","cocoapods","composition","declarative-programming","effects","fp","free-monad","functional-programming","functor","hacktoberfest","monad","mtl","reactive-programming","spm","swift","swift-library","tagless-final"],"latest_commit_sha":null,"homepage":"https://bow-swift.io","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bow-swift.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-03-07T15:01:09.000Z","updated_at":"2024-11-11T16:28:45.000Z","dependencies_parsed_at":"2022-08-21T02:50:15.911Z","dependency_job_id":null,"html_url":"https://github.com/bow-swift/bow","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bow-swift%2Fbow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bow-swift%2Fbow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bow-swift%2Fbow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bow-swift%2Fbow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bow-swift","download_url":"https://codeload.github.com/bow-swift/bow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228923746,"owners_count":17992573,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bow","carthage","category-theory","cocoapods","composition","declarative-programming","effects","fp","free-monad","functional-programming","functor","hacktoberfest","monad","mtl","reactive-programming","spm","swift","swift-library","tagless-final"],"created_at":"2024-01-05T20:15:39.712Z","updated_at":"2025-10-21T10:53:55.558Z","avatar_url":"https://github.com/bow-swift.png","language":"Swift","readme":"![](https://github.com/bow-swift/bow-art/blob/master/assets/bow-header-github.png?raw=true)\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://codecov.io/gh/bow-swift/bow\"\u003e\n\u003cimg src=\"https://codecov.io/gh/bow-swift/bow/branch/master/graph/badge.svg\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://gitter.im/bowswift/bow?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\"\u003e\n\u003cimg src=\"https://badges.gitter.im/bowswift/bow.svg\"\u003e\n\u003c/a\u003e\n\u003cimg src=\"https://img.shields.io/badge/platform-macos%20%7C%20ios%20%7C%20watchos%20%7C%20tvos%20%7C%20linux-success\"\u003e\n\u003ca href=\"https://badge.bow-swift.io/recipe?name=bow\u0026description=Bow%20is%20a%20cross-platform%20library%20for%20Typed%20Functional%20Programming%20in%20Swift\u0026url=https://github.com/bow-swift/bow\u0026owner=bow-swift\u0026avatar=https://avatars3.githubusercontent.com/u/44965417?v=4\u0026tag=0.8.0\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/bow-swift/bow-art/master/badges/nef-playgrounds-badge.svg\" alt=\"bow Playground\" style=\"height:20px\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nBow is a cross-platform library for Typed Functional Programming in Swift.\n\n## Documentation\n\nAll documentation and API reference is published in [our website](https://bow-swift.io/). Some links to key aspects of the library:\n\n- [Higher Kinded Type emulation](https://bow-swift.io/next/docs/fp-concepts/higher-kinded-types/)\n- [Type classes](https://bow-swift.io/next/docs/fp-concepts/type-classes/)\n- [Data types](https://bow-swift.io/next/docs/fp-concepts/data-types/)\n- [Optics](https://bow-swift.io/next/docs/optics/optics-overview/)\n- [Effects](https://bow-swift.io/next/docs/effects/effects-overview/)\n- [Streams](https://bow-swift.io/next/docs/integrations/rxswift-streams/)\n\n## Modules\n\nBow is split into multiple modules that can be consumed independently. These modules are:\n\n- `Bow`: core library. Contains Higher Kinded Types emulation, function manipulation utilities, Typeclasses, Data Types, Monad Transformers, and instances for primitive types.\n- `BowOptics`: module to work with different optics.\n- `BowRecursionSchemes`: module to work with recursion schemes.\n- `BowFree`: module to work with Free Monads.\n- `BowGeneric`: module to work with generic data types.\n- `BowEffects`: module to work with effects.\n- `BowRx`: module to provide an integration with RxSwift.\n\nThere are also some modules for testing:\n\n- `BowLaws`: laws for type classes in the core module.\n- `BowOpticsLaws`: laws for optics.\n- `BowEffectsLaws`: laws for effects.\n- `BowGenerators`: generators for Property-based Testing for data types in the core module.\n- `BowFreeGenerators`: generators for Property-based Testing for data types in BowFree.\n- `BowEffectsGenerators`: generators for Property-based Testing for data types in BowEffects.\n- `BowRxGenerators`: generators for Property-based Testing for data types in BowRx.\n\nBow is available using Swift Package Manager, CocoaPods, and Carthage.\n\n### Swift Package Manager\n\nStarting on Xcode 11, you can use the integration in the IDE with Swift Package manager to bring the dependencies into your project. You only need the repository URL: [https://github.com/bow-swift/bow.git](https://github.com/bow-swift/bow.git). For earlier versions of Xcode, create a `Package.swift` file similar to the next one and use the dependencies at your convenience.\n\n```swift\n// swift-tools-version:5.0\n\nimport PackageDescription\n\nlet package = Package(\n    name: \"BowTestProject\",\n    dependencies: [\n        .package(url: \"https://github.com/bow-swift/bow.git\", from: \"{version}\")\n    ],\n    targets: [\n        .target(name: \"BowTestProject\",\n                dependencies: [\n                    \"Bow\",\n                    \"BowOptics\",\n                    \"BowRecursionSchemes\",\n                    \"BowFree\",\n                    \"BowGeneric\",\n                    \"BowEffects\",\n                    \"BowRx\"]),\n        .testTarget(name: \"BowTestProjectTests\",\n                    dependencies: [\n                        // Type class laws\n                        \"BowLaws\",\n                        \"BowOpticsLaws\",\n                        \"BowEffectsLaws\",\n\n                        // Generators for PBT with SwiftCheck\n                        \"BowGenerators\",\n                        \"BowFreeGenerators\",\n                        \"BowEffectsGenerators\",\n                        \"BowRxGenerators\"])\n    ]\n)\n```\n\nTo build it, just run:\n\n```\n$ swift build\n```\n\n### CocoaPods\n\nYou can consume each Bow module as a separate pod. You can add these lines to your Podfile at your convenience:\n\n```ruby\npod \"Bow\",                 \"~\u003e {version}\"\npod \"BowOptics\",           \"~\u003e {version}\"\npod \"BowRecursionSchemes\", \"~\u003e {version}\"\npod \"BowFree\",             \"~\u003e {version}\"\npod \"BowGeneric\",          \"~\u003e {version}\"\npod \"BowEffects\",          \"~\u003e {version}\"\npod \"BowRx\",               \"~\u003e {version}\"\n```\n\nTesting laws:\n\n```ruby\npod \"BowLaws\",        \"~\u003e {version}\"\npod \"BowOpticsLaws\",  \"~\u003e {version}\"\npod \"BowEffectsLaws\", \"~\u003e {version}\"\n```\n\nGenerators for property-based testing with SwiftCheck:\n\n```ruby\npod \"BowGenerators\",              \"~\u003e {version}\"\npod \"BowFreeGenerators\",          \"~\u003e {version}\"\npod \"BowEffectsGenerators\",       \"~\u003e {version}\"\npod \"BowRxGenerators\",            \"~\u003e {version}\"\n```\n\n### Carthage\n\nCarthage will download the whole Bow project, but it will compile individual frameworks for each module that you can use separately. Add this line to your Cartfile:\n\n```\ngithub \"bow-swift/Bow\" ~\u003e {version}\n```\n\n## Contributing\n\nIf you want to contribute to this library, you can check the [Issues](https://github.com/arrow-kt/bow/issues) to see some of the pending tasks.\n\n### How to run the project\n\nOpen `Bow.xcodeproj` in Xcode 11 (or newer) and you are ready to go. Bow uses the Swift Package Manager to handle its dependencies.\n\n### How to run the documentation project\n\n- Go to the root directory.\n- Run `nef compile --project Documentation.app` to get all dependencies.\n- Open `Documentation.app` and run the project.\n\nFor further information, refer to our [Contribution guidelines](CONTRIBUTING.md).\n\n## How to create a new release\n\nYou can create a new release by running `bundle exec fastlane release version_number:`. For example, `bundle exec fastlane ios release version_number: \"0.8.0\"`.\n\nThe following steps would be run:\n\n- Update the `version` in `*.podspec` files.\n- Create a tag with message added in the `CHANGELOG` file.\n- Deploy podspec files and make them publicly available.\n\n# License\n\n    Copyright (C) 2018-2021 The Bow Authors\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","funding_links":[],"categories":["Functional Programming","Libs","Extensions","HarmonyOS","\u003ca name=\"for-projects\"\u003e\u003c/a\u003e For Projects","Utility [🔝](#readme)","Table of Contents"],"sub_categories":["Getting Started","Utility","Windows Manager","Linter","\u003ca name=\"for-projects-example-projects\"\u003e\u003c/a\u003e Example Projects","Repos"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbow-swift%2Fbow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbow-swift%2Fbow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbow-swift%2Fbow/lists"}