You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+19-15Lines changed: 19 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,30 +3,34 @@ Parse CSV with Javascript
3
3
4
4
[](https://www.gittip.com/mholt/)
5
5
6
-
7
6
Papa Parse (formerly the jQuery Parse Plugin) is a robust and powerful CSV (character-separated values) parser with these features:
8
7
9
-
- Parses delimited text strings without any fuss
10
-
- Attach to `<input type="file">` elements to load and parse files from disk
11
-
- Automatically detects delimiter (or specify a delimiter yourself)
12
-
- Supports streaming large inputs
13
-
- Utilize the header row, if present
14
-
- Gracefully handles malformed data
15
-
- Optional dynamic typing so that numeric data is parsed as numbers
16
-
- Descriptive and contextual errors
8
+
- Easy to use
9
+
- Parse CSV files directly (local or over the network)
10
+
- Stream large files (even via HTTP)
11
+
- Reverse parsing (converts JSON to CSV)
12
+
- Auto-detects the delimiter
13
+
- Worker threads to keep your web page responsive
14
+
- Header row support
15
+
- Can convert numbers and booleans to their types
16
+
- Graceful and robust error handling
17
+
- Minor jQuery integration to get files from `<input type="file">` elements
18
+
19
+
All are optional (except for being easy to use).
20
+
17
21
18
22
19
-
Demo
23
+
[Demo](http://papaparse.com/demo.html)
20
24
----
21
25
22
-
Visit **[PapaParse.com](http://papaparse.com/#demo)** to give Papa a whirl!
26
+
Visit **[PapaParse.com/demo.html](http://papaparse.com/demo.html)** to try Papa!
23
27
24
28
25
29
26
30
Get Started
27
31
-----------
28
32
29
-
Use [jquery.parse.min.js](https://github.com/mholt/jquery.parse/blob/master/jquery.parse.min.js) for production.
33
+
Use [papaparse.min.js](https://github.com/mholt/PapaParse/blob/master/papaparse.min.js) for production.
30
34
31
35
For usage instructions, see the [homepage](http://papaparse.com) and, for more detail, the [documentation](http://papaparse.com/docs.html).
32
36
@@ -35,18 +39,18 @@ For usage instructions, see the [homepage](http://papaparse.com) and, for more d
35
39
Tests
36
40
-----
37
41
38
-
The Parser component is under test. Download this repository and open `tests.html` in your browser to run them.
42
+
Papa Parse is under test (especially its core Parser). Download this repository and open `tests/tests.html` in your browser to run them.
39
43
40
44
41
45
42
46
Contributing
43
47
------------
44
48
45
-
If you'd like to see a feature or bug fix, pull down the code and submit a pull request. But remember, if you're changing anything in the Parser function, a pull request, *with test*, is best. (All changes to the parser component should be validated with tests.) You may also open issues for discussion or join in on Twitter with [#PapaParse](https://twitter.com/search?q=%23PapaParse&src=typd&f=realtime)
49
+
To discuss a new feature or ask a question, open an issue. To fix a bug, submit a pull request to be credited with the [contributors](https://github.com/mholt/PapaParse/graphs/contributors)! Remember, a pull request, *with test*, is best. (Especially all changes to the Parser component should be validated with tests.) You may also discuss on Twitter with [#PapaParse](https://twitter.com/search?q=%23PapaParse&src=typd&f=realtime) or directly to me, [@mholt6](https://twitter.com/mholt6).
46
50
47
51
48
52
49
53
Origins
50
54
-------
51
55
52
-
Papa Parse is the result of an experiment by [SmartyStreets](http://smartystreets.com) which matured into a fully-featured, independent jQuery plugin. Wanting to enhance the demo on their homepage, SmartyStreets looked into ways to simulate their list service. This involved processing at least part of a potentially large delimited text file. And what else? They wanted to do it without requiring a file upload (for simplicity and to alleviate privacy concerns). No suitable solutions were found, so they built their own. After finding it successful, the code was brought out into this jQuery plugin, now known as Papa Parse.
56
+
Papa Parse is the result of a successful experiment by [SmartyStreets](http://smartystreets.com) which matured into a fully-featured, independent Javascript library.
0 commit comments