Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tigerpixel/parsercombinator
A simple Parser Combinator written in Swift
https://github.com/tigerpixel/parsercombinator
apple fp functional-programming ios macos parser parser-combinators parsercombinator swift swift-3 swift-framework swift-library swift3 tvos watchos
Last synced: about 1 month ago
JSON representation
A simple Parser Combinator written in Swift
- Host: GitHub
- URL: https://github.com/tigerpixel/parsercombinator
- Owner: tigerpixel
- License: mit
- Created: 2017-03-17T10:33:29.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2019-10-01T19:33:54.000Z (about 5 years ago)
- Last Synced: 2024-11-13T09:43:35.446Z (about 1 month ago)
- Topics: apple, fp, functional-programming, ios, macos, parser, parser-combinators, parsercombinator, swift, swift-3, swift-framework, swift-library, swift3, tvos, watchos
- Language: Swift
- Homepage:
- Size: 111 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ParserCombinator
[](https://travis-ci.org/tigerpixel/ParserCombinator)
[](http://cocoapods.org/pods/ParserCombinator)
[](http://cocoapods.org/pods/ParserCombinator)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/ParserCombinator)
A simple parser combinator, created in Swift.
ParserCombinator attempts to create a simple and user-friendly way to parse strings into objects and structures. Technical terms are largely avoided and convenience parsers are provided.
The parser can be enacted by calling the 'run' function:
```swift
myParser.run(on: "String to parse")
```
The unit tests provide examples of using the parser and creating your own parsing rules.
Pull requests for improvements are welcome.
## Requirements
There are no external requirements for this project, just Swift.
- iOS 8.0+ / macOS 10.9+ / tvOS 9.0+ / watchOS 2.0+
- Xcode 11+
- Swift 5.1+
For previous versions of Xcode and Swift please see prior releases.
## Installation
### Swift Package Manager
The [Swift Package Manager](https://swift.org/package-manager) is the official tool for managing the distribution of Swift code. It is currently available for all Apple platforms. It can also be used with Linux but this project does not fully support Linux at this point in time.
If you use it to manage your dependencies, simply add ParserCombinator to the dependencies value of your Package.swift file.
```swift
dependencies: [
.package(url: "https://github.com/Tigerpixel/ParserCombinator.git", from: "2.1.0")
]
```
### Cocoapods
ParserCombinator is available through [CocoaPods](https://cocoapods.org/pods/ParserCombinator). To install it, simply add the following line to your Podfile:
```ruby
pod "ParserCombinator"
```
### Carthage
If you use [Carthage](https://github.com/Carthage/Carthage) to manage your dependencies, simply add the following line to your Cartfile:
```ogdl
github "tigerpixel/ParserCombinator"
```
If you use Carthage to build your dependencies, make sure you have added `ParserCombinator.framework` to the "_Linked Frameworks and Libraries_" section of your target, and have included them in your Carthage framework copying build phase.
### Git Submodule
1. Add the ParserCombinator repository as a [submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules) of your application’s repository.
1. Run `git submodule update --init --recursive` from within the ParserCombinator folder.
1. Drag and drop `ParserCombinator.xcodeproj` into your application’s Xcode project or workspace.
1. On the “General” tab of your application target’s settings, add `ParserCombinator.framework`. to the “Embedded Binaries” section.
1. If your application target does not contain Swift code at all, you should also set the `EMBEDDED_CONTENT_CONTAINS_SWIFT` build setting to “Yes”.
## MIT License
ParserCombinator is available under the MIT license. Details can be found within the LICENSE file.