ts-files

BETA RELEASE: the json file reader is not complete

A File reader and writer, for large multi-chunk operations. Works with CSV, JSON, and raw text.

The File operations uses both the fs and stream libraries, with increased customisability and helpful defaults to help prevent string size restrictions, ulimit errors, synchronous write limitations, etc. In addition, many helpful features include JSON structure searches, type parsing, and column based edits.

⚙️ Installation

npm i ts-files

🚀 Quickstart

import { CsvFile, FileStaticMethods } from 'ts-files'

const main = async () => {
  // READ CSV
  const file = await CsvFile.initCreate('sample.csv');
  await file.readCsv(1);  // reading csv in chunks, with 1 header line
  file.header();          // header (as Array<string>)
  file.data();            // data (as Array<Array<string | number | boolean>>)
  file.head(3);           // console.table of first 3 lines
  file.shape();           // shape (eg. [20, 3] is 20 lines with 3 columns)

  // WRITE CSV
  const fileWriter = await CsvFile.initCreate('writing.csv');
  fileWriter.setHeader(['testName', 'testIdx', 'testItem']);
  fileWriter.setData([['john', 1, 2], ['abram', 2, 1]]);
  fileWrite.appendLine(['newline', 1]);
  await fileWrite.writeCsv(2);                      // writes data in 2 chunks
  await fileWrite.appendCsv();                      // appends data (3 lines)
  await fileWrite.appendCsvLine(['append', 2, 1]);  // appends single line

  // STATIC METHODS
  await FileStaticMethods.pathCreate(__dirname + "/testFile.csv", true);
  await FileStaticMethods.pathCreate(__dirname + "/testFolder", false);
  await FileStaticMethods.createIfNotExist(__dirname + "/testFile.csv");
  const directory = await FileStaticMethods.walk(__dirname);
  const file = await FileStaticMethods.pathFind(__dirname, 'testFile.csv');
  const path = await FileStaticMethods.root('testFile.csv');
  await FileStaticMethods.writeStream(file, 'abc');
  const raw = await FileStaticMethods.readStream(file);
  console.log(`directory: ${directory}\nfile: ${file}\npath: ${path}\nraw: ${raw}`);
};

main().then(() => {});