Socket
Socket
Sign inDemoInstall

csv-generate

Package Overview
Dependencies
0
Maintainers
1
Versions
46
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    csv-generate

CSV and object generation implementing the Node.js `stream.Readable` API


Version published
Weekly downloads
1M
decreased by-19.1%
Maintainers
1
Install size
1.14 MB
Created
Weekly downloads
 

Package description

What is csv-generate?

The csv-generate package is a simple and powerful tool for generating CSV data programmatically. It is part of the CSV module suite for Node.js, designed to work with streams and provide a flexible means of generating CSV files with custom settings. This package can be particularly useful for testing, data generation, and simulation purposes.

What are csv-generate's main functionalities?

Synchronous Data Generation

Generate CSV data synchronously. This is useful for small datasets that can be generated and used on the fly without the need for asynchronous handling.

const generate = require('csv-generate');
let output = generate({length: 2});
console.log(output);

Asynchronous Stream Generation

Generate CSV data asynchronously using streams. This method is suitable for larger datasets or when the data generation process is part of a larger, asynchronous workflow.

const generate = require('csv-generate');
const generator = generate({length: 20, objectMode: true});
generator.on('readable', function(){
  let row;
  while ((row = generator.read()) !== null) {
    console.log(row);
  }
});

Custom Column Options

Customize the columns of the generated CSV data. This feature allows for specifying the type of data each column should contain, providing flexibility in the structure of the generated data.

const generate = require('csv-generate');
const output = generate({columns: ['int', 'bool'], length: 2});
console.log(output);

Other packages similar to csv-generate

Readme

Source

CSV generator for Node.js and the web

Build Status NPM NPM

The csv-generate package provides a flexible generator of random CSV strings and Javascript objects implementing the Node.js stream.Readable API. It is part of the CSV project.

Documentation

Main features

  • Scalable stream.Readable implementation
  • random or pseudo-random seed based generation
  • Idempotence with the "seed" option
  • User-defined value generation
  • Multiple types of values (integer, boolean, dates, ...)
  • MIT License

Usage

Run npm install csv to install the full CSV module or run npm install csv-generate if you are only interested by the CSV generator.

Use the callback and sync APIs for simplicity or the stream based API for scalability.

Example

The API is available in multiple flavors. This example illustrates the stream API.

import { generate } from 'csv-generate';
import assert from 'assert';

const records = [];
// Initialize the generator
generate({
  seed: 1,
  objectMode: true,
  columns: 2,
  length: 2
})
  // Use the readable stream api to consume generated records
  .on('readable', function(){
    let record; while((record = this.read()) !== null){
      records.push(record);
    }
  })
  // Catch any error
  .on('error', function(err){
    console.error(err);
  })
  // Test that the generated records matched the expected records
  .on('end', function(){
    assert.deepEqual(records, [
      [ 'OMH', 'ONKCHhJmjadoA' ],
      [ 'D', 'GeACHiN' ]
    ]);
  });

Development

Tests are executed with Mocha. To install it, simple run npm install followed by npm test. It will install mocha and its dependencies in your project "node_modules" directory and run the test suite. The tests run against the CoffeeScript source files.

To generate the JavaScript files, run npm run coffee.

The test suite is run online with Travis. See the Travis definition file to view the tested Node.js version.

Contributors

The project is sponsored by Adaltas, an Big Data consulting firm based in Paris, France.

Keywords

FAQs

Last updated on 27 Feb 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc