+
+```
+
+## Installation
+```
+bower install --save PolymerVis/papa-parse
+```
+
+## Documentation and demos
+More details @ [webcomponents.org](https://www.webcomponents.org/element/PolymerVis/papa-parse).
+
+## Disclaimers
+PolymerVis is a personal project and is NOT in any way affliated with Papaparse, Polymer or Google.
+
+# papa-parse
+`papa-parse` is a Polymer 2.0 element to parse CSV files into JSON object(s)
+with [Papa parse](http://papaparse.com/).
+
+`papa-parse` can download and parse a csv file via `url`, or from raw csv strings via `raw`, and File object via `file`. If the `auto` flag is set, `papa-parse` will automatically start the job, otherwise a manual call to the function `parse` will be needed.
+
+Parse from URL.
+```html
+
+```
+
+Parse from raw csv String.
+```html
+
+```
+
+Parse from FileReader
+```html
+
+
+```
+```javascript
+this.$.selectfile
+ .addEventListener('change', function(e) {
+ this.file = e.target.files[0];
+ });
+```
+
+There are 2 possible outputs for `rows` - an *array of array of values*, or an
+*array of objects*. An array of array is returned if the `header` flag is not
+set, and an array of objects otherwise, where each object is a map comprising
+of the column name and its corresponding value for the row
+(e.g. {col1: value1, col2: value2}).
+
+### Handling big files
+Parsing is synchronous and may block the UI thread (i.e. freeze the screen) if
+the csv file is big. Parsing with a web-worker via `worker` flag is recommended
+for big file. However, note that `papaparse.min.js` *should not be bundled*
+during the build process if web-worker is required as the web-worker needs to
+load the script. You will also need to correctly reference the location of the
+script via the `script-path` attribute.
+
+You should not use relative path if parsing from `url`, as the web-worker may
+load from an incorrect path.
+
+```html
+
+```
+```javascript
+function handleRecord(e, {data, meta, errors}) {
+ console.log(data);
+}
+```
+
+Streaming via `stream` flag is also recommended for big file (`stream` and
+`worker` are not dependent on each other). However, when `stream` flag is set,
+`rows` attribute will only return an empty array as none of the records will be
+persisted. Instead, `papa-parse` will emit an `stream` event of the form
+{{data: Array[]|Object[], meta: Object, errors: Array, parser: Object}} for each
+record parsed.
+
+```html
+
+
+
+```
+```javascript
+function start() {
+ app.$.parser.start();
+}
+
+function handleRecord(e, {data, meta, errors}) {
+ alert(JSON.stringify(data));
+ app.$.parser.pause();
+}
+```
+
+# papa-unparse
+`papa-unparse` is a Polymer 2.0 element to convert JSON arrays or objects into
+CSV strings with [Papa parse](http://papaparse.com/).
+
+**Basic usage**
+For array of objects, e.g. [{col1: 1, col2: 2}, {col1: 3, col2: 4}]
+```html
+
+```
+
+For array of arrays, e.g. [[1,2], [3,4]]
+```html
+
+```
+
+### Download as CSV file
+```html
+
+
+```
+```javascript
+function download() {
+ document.querySelector('papa-unparse').downloadCsv('somefile.csv');
+}
+```
+
+### Other options
+```html
+
+```
diff --git a/bower.json b/bower.json
new file mode 100644
index 0000000..7f75ba5
--- /dev/null
+++ b/bower.json
@@ -0,0 +1,17 @@
+{
+ "name": "papa-parse",
+ "description": "Polymer2 element for CSV parsing with papaparse",
+ "main": "elements.html",
+ "dependencies": {
+ "polymer": "Polymer/polymer#^2.0.0",
+ "papaparse": "^4.3.6"
+ },
+ "devDependencies": {
+ "iron-demo-helpers": "PolymerElements/iron-demo-helpers#^2.0.0",
+ "web-component-tester": "Polymer/web-component-tester#^6.0.0",
+ "webcomponentsjs": "webcomponents/webcomponentsjs#^1.0.0"
+ },
+ "resolutions": {
+ "polymer": "^2.0.0"
+ }
+}
diff --git a/demo/MOCK_DATA.csv b/demo/MOCK_DATA.csv
new file mode 100644
index 0000000..4ff33b5
--- /dev/null
+++ b/demo/MOCK_DATA.csv
@@ -0,0 +1,11 @@
+id,first_name,last_name,email,gender,ip_address
+1,Sheree,Bonniface,sbonniface0@altervista.org,Female,214.100.85.55
+2,Rickey,McClintock,rmcclintock1@walmart.com,Male,106.217.13.41
+3,Bevvy,Orneles,borneles2@wsj.com,Female,200.42.161.215
+4,Meaghan,Penwell,mpenwell3@friendfeed.com,Female,91.176.235.148
+5,Othello,Jarmyn,ojarmyn4@twitpic.com,Male,94.240.223.236
+6,Svend,Lempel,slempel5@linkedin.com,Male,124.105.128.32
+7,Petronilla,Trippitt,ptrippitt6@virginia.edu,Female,67.251.226.133
+8,Christoph,Tapp,ctapp7@ted.com,Male,115.163.62.175
+9,Ethelbert,McShirie,emcshirie8@mediafire.com,Male,29.161.251.48
+10,Lea,Canny,lcanny9@miibeian.gov.cn,Female,80.251.197.178
diff --git a/demo/index.html b/demo/index.html
new file mode 100644
index 0000000..4f6cc7a
--- /dev/null
+++ b/demo/index.html
@@ -0,0 +1,242 @@
+
+
+
+
+
+
+ papa-parse demo
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Basic papa-parse demo
+
+Read from URL without header
+
+
+
+
+
+
+
+
+
+
no. rows w blanks = [[rows.length]]
+
+
no. rows w/o blanks = [[rows_noblanks.length]]
+
+
+
+
+
+
[[item]]
+
+
+
+
+
+
+
+
+
+Read from file with header
+
+
+
+
+
+
+
+
+
+
no. rows = [[rows.length]]
+
+
+
+
+
+
[[item]]
+
+
+
+
+
+
+
[[at(row, key)]]
+
+
+
+
+
+
+
+
+
+
+Read from raw string
+
+
+
+
+
+
+
no. rows = [[rows.length]]
+
+
+
+
+
+
[[item]]
+
+
+
+
+
+
+
[[at(row, key)]]
+
+
+
+
+
+
+
+
+
+
+Streaming
+
+
+
+
+
+
no. of rows = [[rows.length]]
+
+
+
+
+
+
+
+
+
+Parsing with webworker (avoid blocking of UI thread with parsing of large files)
+
+
+
+
+
+
+
+
+
+