2024-06-16 14:31:57 +02:00
|
|
|
# ods-xlsx
|
2024-06-14 16:57:20 +02:00
|
|
|
|
2024-06-18 11:06:41 +02:00
|
|
|
Small lib to parse/understand .ods and .xsls files in the browser and node.js
|
2024-06-14 16:57:20 +02:00
|
|
|
|
|
|
|
|
|
2024-06-16 14:31:57 +02:00
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
### Install
|
|
|
|
|
|
|
|
|
|
```sh
|
2024-07-24 22:09:08 +02:00
|
|
|
npm i https://github.com/DavidBruant/ods-xlsx.git#v0.8.0
|
2024-06-16 14:31:57 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Usage
|
|
|
|
|
|
|
|
|
|
#### Basic
|
|
|
|
|
|
|
|
|
|
```js
|
2024-06-18 11:06:41 +02:00
|
|
|
import {tableRawContentToObjects, tableWithoutEmptyRows, getODSTableRawContent} from 'ods-xlsx'
|
2024-06-16 14:31:57 +02:00
|
|
|
|
|
|
|
|
/**
|
2024-06-18 11:06:41 +02:00
|
|
|
* @param {File} file - an .ods file like the ones you get from an <input type=file>
|
2024-06-16 14:31:57 +02:00
|
|
|
* @return {Promise<any[]>}
|
|
|
|
|
*/
|
|
|
|
|
async function getFileData(file){
|
2024-06-18 11:06:41 +02:00
|
|
|
return tableRawContent
|
|
|
|
|
.then(tableWithoutEmptyRows)
|
|
|
|
|
.then(tableRawContentToObjects)
|
2024-06-16 14:31:57 +02:00
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The return value is an array of objects where
|
|
|
|
|
the **keys** are the column names in the first row and
|
|
|
|
|
the **values** are automatically converted from the .ods or .xlsx files (which type numbers, strings, booleans and dates)
|
|
|
|
|
to the appropriate JavaScript value
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Low-level
|
|
|
|
|
|
2024-06-18 11:06:41 +02:00
|
|
|
See exports
|
2024-06-16 14:31:57 +02:00
|
|
|
|
|
|
|
|
### Demo
|
|
|
|
|
|
|
|
|
|
https://davidbruant.github.io/ods-xlsx/
|
2024-06-14 16:57:20 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Local dev
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
npm install
|
|
|
|
|
npm run dev
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Expectations and licence
|
|
|
|
|
|
2024-06-16 14:31:57 +02:00
|
|
|
I hope to be credited for the work on this repo
|
2024-06-14 16:57:20 +02:00
|
|
|
|
|
|
|
|
Everything written by me and contributors to this repo is licenced under **CC0 1.0 (Public Domain)**
|
|
|
|
|
|
|
|
|
|
|
2024-06-16 14:31:57 +02:00
|
|
|
## Dependencies
|
2024-06-14 16:57:20 +02:00
|
|
|
|
2024-06-16 14:31:57 +02:00
|
|
|
Svelte and rollup are **MIT**-licence
|