npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

bit-meddler

v1.4.1

Published

Fast scrambled, pseudorandom, numbers in a given range touching each value only once without using a flags array or random number generator. Uses a linear feedback shift register.

Downloads

29

Readme

Build Status License: MIT

bit-meddler

Returns randomish integers in a given range.

The practical use of this package doesn't reveal itself until you go for stupid big-ass numbers. Like 100,000 which would take a relatively long time and waste a ton of memory to iterate through and return each integer only once using Math.random() and a flags array.

Watch a live demo here

demo

If Bette Midler ever needed a lightweight method to scramble a range of numbers without resorting to a random number generator or an array, oh boy, she would surely:

npm install --save bit-meddler

...and to scramble those numbers between, say, 1 and 1000:

let bitmeddler = require('bit-meddler');

let meddle = new bitmeddler(1000)

meddle.next(); // give me a number

Calling .next() will return every number between 1 and 1000 in a scrambled, pseudorandom order. The method will return a null once every number has been returned. You can then call .reset() to start again if you wish.

An optional second parameter is a seed number to vary the order:

let seed = 42;
let meddle = new bitmeddler(1000, seed);

If you just want access to the full list of numbers, there's a convenient all method for that:

let meddle = new bitmeddler(1000);

let scrambled = meddle.all(); // return array of 1000 scrambled integers

So it's not "very random" but produces a passable simulation if speed and low memory usage are amongst your requirements. It uses a linear feedback shift register design adapted for software. I remember writing games as a kid on bait hardware bending my brain trying to think of a way to do this without an array. So thanks to this book Game Engine Black Book: Wolfenstein 3D for finally revealing the method to me years later. And also this website was handy.