sussyutilbyraphaelbader v1.8.0

Table of Contents

• Table of Contents
  • Classes
    • AbstractClass
    • Collection
    • DateUtil
    • ImprovedArray
    • IsSomething
    • Random
    • Set
    • Stack
    • StringUtil
  • Functions
    • addProperty
    • asyncHandler
    • attributesToArray
    • betterRound
    • bytesToSize
    • callbackify
    • callIfFunction
    • deepClone
    • getTypeString
    • hasProperty
    • hasValue
    • measureTime
    • merge
    • objectToString
    • removeFirstDigit
    • removeLastDigit
    • removeProperty
    • removeXDigits
    • strickJSONParse
  • Types and Interfaces
    • MapEntry
    • MutableObject
    • PromiseOr
  • Updating
    • Going from 1.0.X to 1.1.X
    • Going from 1.1.X to 1.2.X
    • Going from 1.4.X to 1.5.X
    • Going from 1.5.X to 1.6.X
    • Going from 1.6.X to 1.7.X
  • Change Log
    • v1.5.0
    • v1.6.0-alpha
    • v1.6.0-beta
    • v1.6.0
    • v1.7.0-alpha
    • v1.7.0-beta
    • v1.7.0
    • v1.7.1
    • v1.8.0

Classes

• AbstractClass
• Collection
• DateUtil
• IsSomething
• ImprovedArray
• Random
• Set
• Stack
• StringUtil

AbstractClass

This class allows you to make an abstract class in JavaScript.

Usage:

const { AbstractClass } = require('sussyutilbyraphaelbader');
class SUS extends AbstractClass {
  constructor() {
    super(SUS); // now it will throw an error if you try to make an instance of this class without extending it first
  }
}

Collection

// create a collection
const { Collection } = require('sussyutilbyraphaelbader');
const collection = new Collection();

//usage example
collection.add({ key: /* your key */ , value: /* your value */ });
collection.put({ key: /* your key */ , value: /* your value */ }); // add or replace
const value = collection.get(key);
collection.remove(key);
collection.toArray(); // returns a array of MapEntry
collection.has(key);
collection.missing(key);
collection.toString();
collection.toJSONString();
collection.count(); // returns the amount of entries

DateUtil

// get DateUtil class
const { DateUtil } = require('sussyutilbyraphaelbader');

//static functions
DateUtil.getCurrentDate(); // returns the current date
DateUtil.today(); // returns the current date at 00:00:00
DateUtil.tomorrow(); // returns the next day at 00:00:00
DateUtil.yesterday(); // returns the last day at 00:00:00
DateUtil.conpareDates(date1,date2); // returns and interger based on which date is bigger
DateUtil.equals(date1, date2); // returns boolean based of if both dates are identical
DateUtil.getMonthAbbr(month); // returns the abbreviated month name based on the number given 
DateUtil.getMonthFullName(month); // returns the full month name based on the number given 
DateUtil.getDayAbbr(day); // returns the abbreviated day name based on the number given
DateUtil.getDayFullName(day); // returns the full day name based on the number given
DateUtil.isLeapYear(year); // returns boolean based on if the given year is a leap year
DateUtil.weekFirstDay(); // returns the first week day of the current week
DateUtil.weekLastDay(); // returns the last week day of the current week
DateUtil.leapYearsInRange(12, 2020); // returns all leap years in the given range
DateUtil.getMonthFirstDay(); // returns the first day of the current month
DateUtil.getMonthLastDay(); // returns the last day of the current month

ImprovedArray

// create a ImprovedArray
const { ImprovedArray } = require('sussyutilbyraphaelbader');
const array = new ImprovedArray(/* put initial items here */);

//usage example
// getting items from array
const elm = array[index];
//has all Array functions
array.insertAt(index, ...values); // inserts items at index
array.remove(index); // remove elements from array at index
const index = array.getRandomIndex(); // returns random index of array
const element = array.getRandomElement(); // returns element at random index
array.clear(); // removes all elements
array.clone(); // returns clone
const empty = array.isEmpty(); // returns if the array is empty true else false
array.none(function); // returns true if none of the array elements fits the specified function
array.rejected(function); // opposite of Array.prototype.filter
array.sum(); // returns the sum of all elements of the array
array.removeDuplicates(); // removes duplicates
array.scramble(); // scrambles the array
array.countOccurrences(value); // counts how often the value given is in the array
array.flatten(); // flattens the array
array.toJSONString();

IsSomething

// get IsSomething class
const { IsSomething } = require('sussyutilbyraphaelbader');

// static methods
IsSomething.isArray(); // returns true if the given value is a array
IsSomething.isBoolean(); // returns true if the given value is a boolean
IsSomething.isClass(); // returns if the given value is a class constructor
IsSomething.isDate(); // returns true if the given value is a instanceof Date
IsSomething.isError(); // returns true if the given value is a instanceof Error
IsSomething.isEven(); // returns true if the given  number is even returns null if given value is not a number
IsSomething.isFunction(); // returns true if the given value is a function
IsSomething.isNullorUndefined(); // returns true if the given value is null or undefined
IsSomething.isNumber(); // returns true if the given value is a number or a string which contains only digits
IsSomething.isObject(); // returns true if the given value is a object but not an array
IsSomething.isPrime(); // returns true if the given number is a prime number returns null if given value is not a number
IsSomething.isRegExp(); // returns true if the given value is a regular expression
IsSomething.isString(); // returns true if the given value is a string
IsSomething.isSymbol(); // returns true if the given is a instanceof Symbol

Random

const { Random } = require('sussyutilbyraphaelbader');

Random.randomInt(upper, lower); // returns a random integer with upper and lower bounds given
Random.randomDouble(upper, lower); // returns a random double with upper and lower bounds
Random.randomString(length, charset?); // returns a random string with given length and charset
Random.randomChar(charset?); // returns a random char with given charset
Random.randomElement(array?); // returns a random element of an array

Set

// create a Set
const { Set } = require('sussyutilbyraphaelbader');
const set = new Set();

//usage example
set.push(elm); // put elm in set if not already in set
set.delete(elm); // removes the first elements which equals elm
set.isEmpty(); // returns if set is empty
const elm = set.get(index); // returns elm at index
const length = set.length(); // returns number of elements in set
set.remove(number); // removes the element at index
set.changeCheckFunction(() => {}); // changes the check function for each element
set.toString();
set.toJSONString();

Stack

// create a Stack
const { Stack } = require('sussyutilbyraphaelbader');
const stack = new Stack();

//usage example
stack.push(...elm); // put elm on top of stack
const value = stack.pop(); // returns value on top of stack and removes it
const value = stack.peek(); // returns value on top of stack without removing it
stack.empty(); // returns if stack is empty
stack.toArray(); // returns stack as array
stack.toString();
stack.toJSONString();

StringUtil

// get StringUtil class
const { StringUtil } = require('sussyutilbyraphaelbader');

//static function example usage
StringUtil.reverse("Sussy"); // reverses the string | output: yssus
StringUtil.isDiscordUsername("Sussy#1234"); // checks if string is a discord username | output: true
StringUtil.isStrongPassword("kaljsd"); // checks if string is a strong password | output: false
StringUtil.isWeakPassword("kaljsd"); // checks if string is a weak password | output: true
StringUtil.isEmail("sussyBalls@gmail.com"); // checks if string is a email  | output: true
StringUtil.isInteger("12wqeq"); // output: false
StringUtil.isURL("https://sus.com/"); // output: true
StringUtil.shorten("Amogus SUS", length, elipse count);
StringUtil.slugify("Amogus SUS"); // returns amogus-sus
StringUtil.stripHtmlTags("<sussy> balls </sussy>") // removes html tags | returns balls
StringUtil.capitalize("no bitches?"); // Makes the first letter uppercase and the rest lowercase | returns No bitches?
StringUtil.isIPv6("::1"); // checks if string is a IPv6 address | returns true
StringUtil.isIPv4("127.0.0.1"); // checks if string is a IPv4 address | returns true
StringUtil.isIP("168.10.0.1"|"c927:501c:abf9:bc8f:c86d:541a:c354:120f"); // checks whether string is a IP address or not | eturns true
StringUtil.isMacAddress("82-D3-32-D3-5D-43"); // checks if string is a MAC address |  returns true
StringUtil.isPhoneNumber(""); // checks if string is a phone number
StringUtil.camelCase("sus amogus"); // uses the capitalize function | returns Sus Amogus
StringUtil.randomColorCode(); // returns random hex color code
StringUtil.randomCharacter(charset?); // returns a random character based on the current charset
StringUtil.randomString(length, charset?); // returns a random string with the length given
StringUtil.randomDiscordUsername(withSufix:boolean); // returns a random string with length 4 - 32 if withSufix is true then # and 4 random numbers will be added
StringUtil.generatePassword(length, charset?); // returns a random strong password with given length if charset allows it
StringUtil.wordCount(string); // returns the amount of words in the string
StringUtil.getRatingString(number of stars); // 1 - 5 stars returns full/empty stars
StringUtil.normalizeLineBreaks(string, lineEnd?); // returns string with only one type of line break
StringUtil.contains(string, searchsParam); // returns boolean based on if the second string is in the first string
StringUtil.repeat(string, number); // returns string repeated number amount of times
StringUtil.rpad(string, number); // returns string padded on the right site to given length: number
StringUtil.lpad(string, number); // returns string padded on the left site to given length: number
StringUtil.uncapitalize(string);
StringUtil.isFloat(string);
StringUtil.splice();
StringUtil.rtrim();
StringUtil.ltrim();

Functions

• addProperty
• asyncHandler
• attributesToArray
• betterRound
• bytesToSize
• callbackify
• callIfFunction
• deepClone
• getTypeString
• hasProperty
• hasValue
• measureTime
• merge
• objectToString
• removeFirstDigit
• removeLastDigit
• removeProperty
• removeXDigits
• strickJSONParse

addProperty

const { addProperty } = require('sussyutilbyraphaelbader');
addProperty({sus:true}, "imposter", true); // output: { sus:true, imposter:true }

asyncHandler

const { asyncHandler } = require('sussyutilbyraphaelbader');
const [ result, error ] = await asyncHandler(promiseFunction, params);
if(error) {
  console.log(error);
}

if(result) {
  // do stuff
}

attributesToArray

const { attributesToArray } = require('sussyutilbyraphaelbader');
attributesToArray({ sus:true, imposter:true }, true); // output: [true, true];

betterRound

const { betterRound } = require('sussyutilbyraphaelbader');
console.log(betterRound(123.56, 1)); // output: 123.6

bytesToSize

const { bytesToSize } = require('sussyutilbyraphaelbader');
const bytesString = bytesToSize(12300);
console.log(bytesString); // output: 12.0 KB

callbackify

const { callbackify, betterRound } = require('sussyutilbyraphaelbader');
callbackify(betterRound, (res, err) => {
  if(err) {
    //do something
  }
  console.log(res); // output: 123.12
},
123.123, 2);

callIfFunction

const { callIfFunction } = require('sussyutilbyraphaelbader');
callIfFunction(() => true); // output: true
callIfFunction({hi:false}); // output: null

deepClone

const { deepClone } = require('sussyutilbyraphaelbader');
deepClone({er:true, us:{or:true}}): // output: {er:true, us:{or:true}}

getTypeString

const { getTypeString } = require('sussyutilbyraphaelbader');
getTypeString(213); // output: number
getTypeString("sad"); // output: string
getTypeString(class sus { constructor(){} }); // output: class
getTypeString(() => {}); // output: function

hasProperty

const { hasProperty } = require('sussyutilbyraphaelbader');
hasProperty({ sus:true }, "sus"); // output: true

hasValue

const { hasValue } = require('sussyutilbyraphaelbader');
console.log(hasValue(123)); // output: true
console.log(hasValue([]); // output: false
console.log(hasValue([23]); // output: true
console.log(hasValue([[],[]]); // output: false
console.log(hasValue(() => {})); // output: true
console.log(hasValue(undefined)); // output: false
console.log(hasValue(true)); // output: true
console.log(hasValue(false)); // output: true
console.log(hasValue(new RegExp())); // output: false
console.log(hasValue(new RegExp("sus")); // output: true
console.log(hasValue(""); // output: false
console.log(hasValue(" amogus "); // output: true

measureTime

const { measureTime } = require('sussyutilbyraphaelbader');
measureTime(label, function, params); // logs the time it takes to run the function

merge

const { merge } = require('sussyutilbyraphaelbader');
console.log(merge({ a:12, b:34 }, { m:34 })); // output: { a:12, b:34, m:34 }

objectToString

const { objectToString } = require('sussyutilbyraphaelbader');
objectToString({}); // output: [object Object]

removeFirstDigit

const { removeFirstDigit } = require('sussyutilbyraphaelbader');
console.log(removeFirstDigit(123); // output: 23

removeLastDigit

const { removeLastDigit } = require('sussyutilbyraphaelbader');
console.log(removeLastDigit(123)); // output: 12

removeProperty

const { removeProperty } = require('sussyutilbyraphaelbader');
removeProperty({ sus:true, imposter:true }, "imposter"); // output: { sus:true }

removeXDigits

const { removeXDigits } = require('sussyutilbyraphaelbader');
console.log(removeXDigits(7213, 3); // removes x amount of digits from behind | output: 7

strickJSONParse

const { strickJSONParse } = require('sussyutilbyraphaelbader');
strickJSONParse("{ sus:true }"); // output: { sus:true }

Types and Interfaces

• MapEntry
• MutableObject
• PromiseOr

MapEntry

const { MapEntry } = require('sussyutilbyraphaelbader');
const keyValue = {} as MapEntry;
console.log(keyValue); // output: { key: undefined, value: undefined };

MutableObject

const { MutableObject } = require('sussyutilbyraphaelbader');
const sussy = { sus:true, imposter:true, mine:"no" } as MutableObject<any>;
sussy["temp"] = 3; // allowed

PromiseOr

const { PromiseOr } = require('sussyutilbyraphaelbader');
function dummy():PromiseOr<string> {}; // returns promise<string> | string

Updating

Going from 1.0.X to 1.1.X

renamed Class impArray to improvedArray

// old
const { impArray } = require('sussyutilbyraphaelbader');
const array = new impArray();

// new
const { improvedArray } = require('sussyutilbyraphaelbader');
const array = new improvedArray();

Going from 1.1.X to 1.2.X

renamed Class improvedArray to ImprovedArray

// old
const { improvedArray } = require('sussyutilbyraphaelbader');
const array = new improvedArray();

// new
const { ImprovedArray } = require('sussyutilbyraphaelbader');
const a = new ImprovedArray();

Going from 1.4.X to 1.5.X

Made all the non static String Functions static

// old
const { StringUtil } = require('sussyutilbyraphaelbader');
const util = new StringUtil();
util.generatePassword(length);

// new
const { StringUtil } = require('sussyutilbyraphaelbader');
StringUtil.generatePassword(length, charset?);

Going from 1.5.X to 1.6.X

Brought all isSomething functions into the IsSomething class as static functions

// old
const { isFunction } = require('sussyutilbyraphaelbader');
isFunction(() => { return true }) // output: true

// new
const { IsSomething } = require('sussyutilbyraphaelbader');
IsSomething.isFunction(() => {}); // output: true

Going from 1.6.X to 1.7.X

// old	
const { getNumberInRange } = require('sussyutilbyraphaelbader');
getNumberInRange(1,4);

// new
const { Random } = require('sussyutilbyraphaelbader');
Random.randomInt(1,4);

Change Log

v1.5.0

Changes

changed StringUtil.prototype.generatePassword to StringUtil.generatePassword added new param to StringUtil.generatePassword changed StringUtil.prototype.generateString to StringUtil.generatePassword added new param to StringUtil.generateString changed StringUtil.prototype.generateCharacter to StringUtil.generateCharacter added new param to StringUtil.generateCharacter changed merge to accept MutableObject instead of Object

New

added callIfFunction function added attributesToArray function added addProperty function added hasProperty function added isObject function added removeProperty function added DateUtil.getMonthFirstDay added DateUtil.getMonthLastDay added ImprovedArray.prototype.flatten added StringUtil.contains added StringUtil.getRatingString added StringUtil.normalizeLineBreaks added StringUtil.wordCount added MutableObject interface

v1.6.0-alpha

New

added IsSomething class added IsSomething.isArray function added IsSomething.isBoolean function added IsSomething.isClass function added IsSomething.isDate function added IsSomething.isError function added IsSomething.isEven function added IsSomething.isFunction function added IsSomething.isNullorUndefined function added IsSomething.isNumber function added IsSomething.isObject function added IsSomething.isOdd function added IsSomething.isPrime function added IsSomething.isRegExp function added IsSomething.isString function added IsSomething.isSymbol function

v1.6.0-beta

New

added objectToMutableObject function added IsSomething.isDefined function added IsSomething.isEmpty function added IsSomething.isInfinite function added IsSomething.isPrimitive function added IsSomething.isType function added IsSomething.isInstanceOf function

v1.6.0

Change

deprecated isArray function deprecated isBoolean function deprecated isClass function deprecated isDate function deprecated isError function deprecated isEven function deprecated isFunction function deprecated isNullorUndefined function deprecated isNumber function deprecated isObject function deprecated isOdd function deprecated isPrime function deprecated isRegExp function deprecated isString function deprecated isSymbol function

v1.7.0-alpha

Change

renamed function StringUtil.isNumber to StringUtil.isInteger

Added

added StringUtil.splice function added StringUtil.isFloat function added StringUtil.ltrim function added StringUtil.rtrim function

Remove

removed isArray function removed isBoolean function removed isClass function removed isDate function removed isError function removed isEven function removed isFunction function removed isNullorUndefined function removed isNumber function removed isObject function removed isOdd function removed isPrime function removed isRegExp function removed isString function removed isSymbol function

v1.7.0-beta

Change

deprecated getNumberInRange function

Added

added Random class added Random.prototype.randomInt function added Random.prototype.randomDouble function added Random.prototype.randomChar function added Random.prototype.randomString function added primefactors function

v1.7.0

Change

deprecated objectToMutableObject function changed Random.prototype.randomInt to Random.randomInt changed Random.prototype.randomDouble to Random.randomDouble changed Random.prototype.randomString to Random.randomString changed Random.prototype.randomChar to Random.randomChar

Added

added Collection.prototype.count function added Collection.prototype.put function added Collection.prototype.has function added Collection.prototype.missing function added Collection.prototype.toJSONString function added StringUtil.uncapitalize function added ImprovedArray.prototype.toJSONString function added Set.prototype.toJSONString function added Stack.prototype.toJSONString function added type PromiseOr added getObjectKeys function added getProjectRoot function

v1.7.1

Change bugfix in primefactors updated hasValue function bugfix in hasValue updated hasProperty

Added added Random.randomElement

v1.8.0

Added

added AbstractClass class added BetterMath class added AbstractClassInstanceCallError error-class added stringToB64 function added b64ToString function added ImprovedArray.prototype.shuffle function added BetterMath.round function added BetterMath.random function added BetterMath.distance function added BetterMath.square function added IsSomething.isDateValid function added Random.randomElementInRange function added StringUtil.camelToKebab function added Point Interface

Change

made DateUtil an AbstractClass made Random as AbstractClass made IsSomething an AbstractClass made StringUtil as AbstractClass added new parameter to stack constructor deprecated betterRound function

Remove

removed objectToMutableobject function removed getRandomNumberInRange function