threads-manager
v1.0.0
Published
The threads-manager module is designed to simplify the management of worker threads in a Node.js environment. It provides a structured way to create, execute, and handle worker threads that perform asynchronous tasks.
Downloads
16
Maintainers
Readme
Threads Manager
The threads-manager module is designed to simplify the management of worker threads in a Node.js environment. It provides a structured way to create, execute, and handle worker threads that perform asynchronous tasks.
Installation
To install the library, use npm:
npm install threads-manager
Key Features:
- Dynamic Worker Creation: Allows for the initialization of worker threads with user-defined functions that can be executed asynchronously.
- Execution Handling: Facilitates sending tasks to worker threads and receiving results, including success and error handling.
- Callbacks for Success and Error: Provides methods to set up callbacks that execute on successful completion of a task or when an error occurs, allowing for easy integration into larger applications.
- Graceful Termination: Includes functionality to gracefully terminate worker threads when they are no longer needed, helping to manage system resources effectively. This module is particularly useful for tasks that require intensive computation or long-running processes, ensuring that the main application remains responsive while offloading heavy work to worker threads.
Usage
Example
const { createWorkerThread } = require('threads-manager');
const workerThread = createWorkerThread();
// Define a function to be executed by the worker
const exampleFunction = (input) => {
// Simulate some processing
return `Processed: ${input}`;
};
// Set up the success callback
workerThread.onSuccess((successData) => {
console.log('Worker succeeded with data:', successData);
});
// Run the worker thread with the function and data
workerThread.run(exampleFunction, 'Some input data');
// Handle errors and exit as needed
workerThread.onError(() => console.log('Error occurred in worker.'));
workerThread.onExit(() => console.log('Worker has exited.'));
Contributing
We welcome contributions to the library! To contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/YourFeature
). - Make your changes.
- Commit your changes (
git commit -am 'Add new feature'
). - Push to the branch (
git push origin feature/YourFeature
). - Create a new Pull Request.
Please ensure your code adheres to our coding standards and includes appropriate tests.
License
This library is licensed under the MIT License.