https://github.com/peternaydenov/batch-runner

Execute a batch job with a simple call
https://github.com/peternaydenov/batch-runner

batch execute job runner

Last synced: 4 days ago
JSON representation

Execute a batch job with a simple call

• Host: GitHub
• URL: https://github.com/peternaydenov/batch-runner
• Owner: PeterNaydenov
• License: mit
• Created: 2023-11-19T06:15:09.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-10-30T08:31:45.000Z (17 days ago)
• Last Synced: 2024-10-30T09:21:13.609Z (16 days ago)
• Topics: batch, execute, job, runner
• Language: JavaScript
• Homepage:
• Size: 720 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changelog.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Batch Runner (@peter.naydenov/batch-runner)

![version](https://img.shields.io/github/package-json/v/peterNaydenov/batch-runner)

![GitHub License](https://img.shields.io/github/license/peterNaydenov/batch-runner)

![GitHub issues](https://img.shields.io/github/issues-raw/peterNaydenov/batch-runner)

![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40peter.naydenov%2Fbatch-runner)

## Description

Execute a batch job with a simple call. Batch itself contains a name, source of data and a job to be executed. Batch runner will execute the job for each item in the source.

Source is a function that returns an array of items. Source function will be executed on each job run request so the source can be dynamic. Each item will be passed to the job function.

In job run request you can provide extra data parameters that will be passed to the job function as well after the item from the source.

Library `batch-runner` is a framework agnostic. No dependencies.

## Installation

Here is how to install the library:

```

npm i @peter.naydenov/batch-runner

```

## Methods

Library has only two methods:

```js

  define : 'define a batch'

, run   : 'run a batch'

```

## Definition of Batch

    

```js

batch.define ( {

      name   : 'string. Name of the batch'

    , source : 'function. Should return a source of data for the job'

    , job    : 'job to be executed'

```

## How to use

Simplified example:

```js

import batchRunner from '@peter.naydenov/batch-runner'

const batch = batchRunner();

batch.define ({

                      name   : 'myBatch'

                    , source : () => [1, 2, 3]

                    , job    : ({item,i,END},x) => console.log(item,x)

            });

batch.run ( 'myBatch', 'extra') // Extra parameter will be passed to the job function

// -> 1,extra

// -> 2,extra

// -> 3,extra

// Number of extra parameters is not limited

```

Job definition first argument is an object `{item,i,END}`, where `item` is the current item, `i` is the current source index, `END` is constant. To stop further function evocation return the `END` constant.

Example:

```js

batch.define ({

                      name   : 'myBatch'

                    , source : () => [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]

                    , job    : ({item,i,END},x) => {

                                    return ( i < 2 ) ? item : END

                                  }

            });

let r = batch.run ( 'myBatch' )

// r -> [1,2]

```

## Links

- [History of changes](https://github.com/PeterNaydenov/batch-runner/blob/main/Changelog.md)

- [Migration Guides](https://github.com/PeterNaydenov/batch-runner/blob/main/Migration.guide.md)

## Credits

'@peter.naydenov/batch-runner' was created and supported by Peter Naydenov.

## License

'@peter.naydenov/batch-runner' is released under the [MIT License](http://opensource.org/licenses/MIT).