odfjs/readme.md

66 lines
1.2 KiB
Markdown
Raw Normal View History

2024-06-16 14:31:57 +02:00
# ods-xlsx
2024-06-14 16:57:20 +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
npm i https://github.com/DavidBruant/ods-xlsx.git#v0.8.0
2024-06-16 14:31:57 +02:00
```
### Usage
#### Basic
```js
import {tableRawContentToObjects, tableWithoutEmptyRows, getODSTableRawContent} from 'ods-xlsx'
2024-06-16 14:31:57 +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){
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
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