stuffs/readme.md

Some useful stuffs packed to here.

# STUFFS

Some useful stuffs packed to here.

## Utilities

- accurateSleep
- chunkify
- chunkifyString
- combinations
- defaultify
- escapeRegex
- execAsync
- fillGaps
- formatDuration
- formatSeconds
- getFileExtension
- getValueType
- hexToRgb
- intToRgba
- isThenable
- makeSureFileExists
- makeSureFileExistsSync
- makeSureFolderExists
- makeSureFolderExistsSync
- mapReplace
- parseDuration
- percent
- randomFloat
- randomInteger
- randomPick
- randomString
- rejectAfter
- rgbaToInt
- rgbToHex
- sleep
- threeDots
- validateShape
- cronDayTrigger
- cronHourTrigger
- cronMinuteTrigger
- broadcastProxy

### Update history

#### 0.1.43
- `formatDuration(ms, formatting)` now supports excluding time parts!
```js
formatDuration(1767229200000,{
  years: null,
  months: null,
  weeks: null,
  days: ["day", "days"],
  hours: ["hour", "hours"],
  minutes: ["minute", "minutes"],
  seconds: ["second", "seconds"]
});
```

#### 0.1.41
- Added `broadcastProxy(anyArrayOfT): T`.
```js
const apple = {
  delicious: true,
  eat: () => console.log("Apple is delicious")
};

const avocado = {
  delicious: false,
  eat: () => console.log("Avocado is gross")
};

const fruitBroadcast = broadcastProxy([apple, avocado]);

fruitBroadcast.eat();
// Apple is delicious
// Avocado is gross

console.log(fruitBroadcast.delicious);
// [true, false]
```

#### 0.1.40
- Added `cronMinuteTrigger(minuteMarks, callback)`. Eg: `cronMinuteTrigger([0, 15, 30, 45], () => { console.log("Triggered"); })`
- Added `cronHourTrigger(hourMarks, callback)`. Eg: `cronHourTrigger([0, 6, 12, 18], () => { console.log("Triggered"); })`
- Added `cronDayTrigger(dayMarks, callback)`. Eg: `cronDayTrigger([0, 3, 5], () => { console.log("Triggered"); })`

#### 0.1.36
- Added `chunkifyString(str, chunkSize, separator?)`. Eg: `chunkifyString("Hello, world!", 7, ",")` -> `["Hello", " world!"]`

#### 0.1.32
- Added `formatDuration(ms, formatting?)`. Eg: `formatDuration(600000000)` -> `6 days, 22 hours, 40 minutes`

#### 0.1.29

- Added recursive option to `mapReplace(text, map, recursive=true)`. Eg: `mapReplace({ test: 1, test2: "hello", deep: { test3: "world" } }, {"hello": "hey", "world": "guy"}, true) => { test: 1, test2: "hey", deep: { test3: "guy" } }`

#### 0.1.23

- `combinations(["1","2","3"])` added. Eg: [...combinations(["1","2","3"])] -> [["1"],["2"],["1","2"],["3"],["1","3"],["2","3"],["1","2","3"]]

#### 0.1.22

- `parseDuration(str)` added. Eg: parseDuration("1m30s") -> 90000

#### 0.1.21

- Much better Typescript support.

#### 0.1.20

- Typescript support.

#### 0.1.19

- `mapReplace(text, map)` now `map` argument supports entry mappings. Eg: `[[/a/g, "aaa"], [/b/g, "bbb"]]`;

#### 0.1.18

- `fillGaps(array)` added. Eg: fillGaps([1, 2, 5]) -> [1, 2, 3, 4, 5]

#### 0.1.15

- Fixed `defaultify()` on arrays..

#### 0.1.14

- `validateShape(data, originalData, recursive=true)` added. Validates object shape based on original object types.
- `getValueType(value)` added. Eg: getValueType("") -> String, getValueType([]) -> Array

#### 0.1.13

- `defaultify(data, defaultData, recursive=true)` added.

#### 0.1.12

- `execAsync(cmd, cwd?)` added.

#### 0.1.11

- `execAsync(cmd)` added.

#### 0.1.10

- `escapeRegex(str)` added.

#### 0.1.9

- `mapReplace(text, map)` added.
  - Example: `mapReplace('Hello, world!', {'world': 'Universe'})`

#### 0.1.8

- `formatSeconds(seconds)` added. Formats seconds to cool-looking string. formatSecond(363) -> '06:03'

#### 0.1.7

- `chunkify(array, chunkSize)` added. Chunks an array into smaller arrays.

#### 0.1.6

- `accurateSleep(milliseconds)` added. For much better for millisecond-level accuracy. But uses more resources.

#### 0.1.5

- Some changes on `defaultify`.

#### 0.1.4

- `makeSureFolderExists(path)` added.
- `makeSureFolderExistsSync(path)` added.
- `makeSureFileExists(path, content, encoding?)` added.
- `makeSureFileExistsSync(path, content, encoding?)` added.

#### 0.1.3

- `defaultify(data, defaultData)` added. (Data is a object)

#### 0.1.2

- `percent(part, total, maxVal?, nanVal?)` added.
- `threeDots(text, maxLength)` added.

#### 0.1.1

- `isThenable(any)` added.

#### 0.1.0

- Code cleaned.
- You can now only get only parts you need. (eg. `require('stuffs/lib/randomString')`)
- Better readme.
- `randomString(length?, map?)` added.
  - Some maps added for random string.
    - `randomString.STRING_MAP_HEX`
    - `randomString.STRING_MAP_NUMERIC`
    - `randomString.STRING_MAP_ALPHABET_LOWER`
    - `randomString.STRING_MAP_ALPHABET_UPPER`
    - `randomString.STRING_MAP_ALPHANUMERIC`
- `rejectAfter(ms, reason?)` added.
  - Throws an error after some time.