PaceTrace ⏳: A Lightweight Progress Bar CLI Library
Tags: javascript, node
Published: 2023-06-01 18:20:46

Hey there, fellow code enthusiasts! 🖐️

Ever found yourself staring at the screen, waiting for an endless script to finish or a gigantic file to upload? 😓 Well, I've been there, done that. After some sleepless nights of coding and tons of coffee ☕, I'm proud to present: PaceTrace, a progress bar library for Node.js that's as customizable as it is user-friendly!


## 🌟 Here's What PaceTrace Can Do 🌟

So, why should PaceTrace be your new darling in the vast sea of progress bar libraries? 🌊 Let's dive in:

- **Make it your own:** With PaceTrace, you choose your progress bar's length and appearance. Stick with the trusty '=' or '#', go for a sleek '█', or add some fun with '⣿', '★', '♥', or even a character of your own choosing! 🌈

- **Pick a side... or the middle:** Left? Right? Center? Your progress bar, your call! 🎯

- **Show or hide the progress percentage:** It's your choice whether to display the progress percentage or keep it hidden. 🕵️

- **Play with the format:** PaceTrace lets you set your progress bar format. You can use placeholders for the bar, percentage, current value, and total value. 🛠️

- **Automatic stop and clear:** Configure PaceTrace to pause the progress bar automatically when it's done, or even wipe the console clean. 🧹

- **Cursor visibility:** If you prefer not having the console cursor showing while the progress bar is active, simply hide it. 🐭


## 📦 Installation: A Walk in the Park 🌳

Getting PaceTrace on your system is a breeze. All it takes is a simple npm command:


```shell
npm install pace-trace
```
For those of you using yarn, fear not! We've got you covered:

```shell
npm install pace-trace
```


## 🚀 How Do You Use PaceTrace? 🚀

Getting PaceTrace up and running is as easy as pie 🥧. Just import it, create a new instance, and you're off to the races:

```javascript
import PaceTrace from 'pacetrace';

const progress = new PaceTrace(100, { barStyle: 'star' });
```
Then, increment or decrement the progress to your heart's content:

```javascript
progress.increment(10);
progress.decrement(5);
```

When you're ready to show off the progress bar, simply call the log method:

```javascript
progress.log();
```

## 👨‍💻 Behind the Scenes 👩‍💻

PaceTrace is brought to life with TypeScript, promising type safety and providing Visual Studio Code users with top-notch IntelliSense support. And of course, we've got a suite of tests to ensure the library is as reliable as it gets, covering both main functionalities and those tricky edge cases. 💪

## 🎈 Wrapping Up 🎈

In a nutshell, PaceTrace is here to jazz up your console output with a customizable progress bar. It's open-source and just an npm install away. So, what are you waiting for? Give it a whirl and drop a line to let me know your thoughts. Happy coding! 🚀🎉

## 🤝 Let's Collaborate and Innovate Together 🚀

PaceTrace is more than just a library; it's a testament to the power of open-source collaboration. Your insights, your creativity, and your passion can take it to new heights.

So, don't be a stranger! If you've got a great idea or a constructive critique, we're all ears. Feel free to open issues, submit pull requests, or just drop a 🌟 if you like what you see. After all, it's the thoughts and contributions from you, the amazing coding community, that keep the wheels of innovation turning.

Here's where the magic happens: [PaceTrace on GitHub](https://github.com/guaregua19/pace-trace)

Together, we can make PaceTrace an even more powerful tool for Node.js developers worldwide. Ready to jump in? Let's code a better tomorrow, one progress bar at a time! 🛠️🌐🎉