open-index/open-npm huggingface dataset:
npm package: @kafkaman-labs/kafkaman-collection
Description: Enables developers to use a unified Kafkaman Collection format Object across projects
Author: Kafkaman
Latest version: 0.0.9

# Kafkaman Collection SDK 

Kafkaman Collection SDK is a NodeJS module that allows a developer to work with Kafkaman Collections. Using this module a
developer can create collections, manipulate them and then export them in a format that the Kafkaman Apps and Kafkaman CLI
Runtimes (such as [Kafkaman-CLI]) can consume.

A collection lets you group individual requests together. These requests can be further organized into folders to
accurately mirror your services to test. Requests can also store sample responses when saved in a collection. You can add metadata
like name and description too so that all the information that a developer needs is available easily.

To know more about Kafkaman Collections, visit the
[collection documentation section on Kafkaman Website](https://www.kafkaman.com/collection).


## Installing the SDK

Kafkaman Collection SDK can be installed using NPM or directly from the git repository within your NodeJS projects. If
installing from NPM, the following command installs the SDK and saves in your `package.json`

```terminal
> npm install kafkaman-collection --save
```


## Getting Started

In this example snippet we will get started by loading a collection from a file and output the same in console.

```javascript
var fs = require('fs'), // needed to read JSON file from disk
	Collection = require('kafkaman-collection').Collection,
	myCollection;

// Load a collection to memory from a JSON file on disk (say, sample-collection.json)
myCollection = new Collection(JSON.parse(fs.readFileSync('sample-collection.json').toString()));

// log items at root level of the collection
console.log(myCollection.toJSON());
```

After loading the collection from file, one can do a lot more using the functions that are available in the SDK. To know
more about these functions, head over to
[Collection SDK Docs](http://www.kafkaman.com).

## Kafkaman Collection Schema

The collection schema outlines the JSON definition of data structure accepted by the constructor of each properties of
this SDK. In other words, this SDK provides JavaScript level object manipulation for the JSON structure defined by
Kafkaman Collection Format in [http://schema.Kafkaman.com/].

| Schema Version | Compatible SDK Versions |
|----------------|-------------------------|
| 1.0            | none                    |


Conceptually, a JSON input to the constructor of an SDK property should provide similar output when that property
instance's `.toJSON()` is called.