Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Nero5023/CSVParser
A swift package for read and write CSV file
https://github.com/Nero5023/CSVParser
csv-parser swift
Last synced: about 1 month ago
JSON representation
A swift package for read and write CSV file
- Host: GitHub
- URL: https://github.com/Nero5023/CSVParser
- Owner: Nero5023
- License: mit
- Created: 2016-09-27T04:35:43.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-05-16T09:46:32.000Z (over 5 years ago)
- Last Synced: 2024-07-31T15:01:32.230Z (4 months ago)
- Topics: csv-parser, swift
- Language: Swift
- Size: 79.1 KB
- Stars: 85
- Watchers: 10
- Forks: 12
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-swift - CSVParser - Fast parser for CSV. (Libs / Data Management)
- awesome-swift - CSVParser - Fast parser for CSV. (Libs / Data Management)
- awesome-swift - CSVParser - A swift package for read and write CSV file ` 📝 2 years ago` (Data Management [🔝](#readme))
- awesome-swift - CSVParser - Fast parser for CSV. (Libs / Data Management)
README
# CSVParser
A swift library for fast read and write CSV file. This library supports all Apple platform and **Linux**.
[](https://github.com/Carthage/Carthage)
[](https://github.com/Nero5023/CSVParser)
## List to do
---
- [x] get column by string subscript
- [x] error
- [x] initialization from string
- [x] Convert JSON To CSV
- [x] Convert CSV To JSON
- [ ] Concurrent parse
## Requirements
---
* Swift 4.0+
## Installation
---
### Swift Package Manager(Support Ubuntu)
**If you want to use this package on Ubuntu, you shounld install with Swift Package Manager**
In `Package.swift` file
```swift
import PackageDescription
let package = Package(
name: "YourProject",
dependencies: [
.Package(url: "https://github.com/Nero5023/CSVParser",
majorVersion: 1),
]
)
```
Run command
```bash
$ swift build
```
### Carthage
To integrate CSVParser into your Xcode project using Carthage, specify it in your `Cartfile`:
github "Nero5023/CSVParser" ~> 2.0.0
Run `carthage update` to build the framework and drag the built `CSVParser.framework` into your Xcode project.
## Usage
### Initialization
```swift
let csv = try CSVParser(filePath: "path/to/csvfile")
//catch error
do {
let csv = try CSVParser(filePath: "path/to/csvfile")
}catch {
// Error handing
}
// Custom delimiter
do {
let csv = try CSVParser(filePath: "path/to/csvfile", delimiter: ";")
}catch {
// Error handing
}
// init from elements
let csv = try CSVParser(elements: [["a", "b", "c"], ["1", "2", "3"]])
```
### Read data
```swift
do {
let csv = try CSVParser(filePath: "path/to/csvfile")
// get every row in csv
for row in csv {
print(row) // ["first column", "sceond column", "third column"]
}
// get row by int subscript
csv[10] // the No.10 row
// get column by string subscript
csv["id"] // column with header key "id"
}catch {
// Error handing
}
```
### Write data
```swift
do {
let csv = try CSVParser(filePath: "path/to/csvfile")
// get every row in csv
csv[0] = ["test0", "test1", "test2"]
csv.wirite(toFilePath: "path/to/destination/file")
}catch {
// Error handing
}
```
### Subscript
```swift
// get row by int subscript
csv[10] // the No.10 row
// get column by string subscript
csv["id"] // column with header key "id"
```
### Get dictionary elements
```swift
for dic in csv.enumeratedWithDic() {
print(dic) // dic is [String: String]
}
```
### CSV to JSON
The result json type is `[{"header0": "a","header1": "b"},{"header0": "a", "header1": "b"}]`
```swift
do {
let jsonStr = try csv.toJSON()
}catch {
// Error handing
}
```
### JSON to CSV string
Now only support this json type `[{"header0": "a","header1": "b"},{"header0": "a", "header1": "b"}]`
```swift
do {
let csvString = try CSVParser.jsonToCSVString(jsonData: jsonData) // jsonData is the Data type ot json
}catch {
// Error handing
}
```