Git Product home page Git Product logo

foxrandomstring.js's Introduction

FoxRandomString.js

Random string Javascript object with specified types of the output

Generate Random Strings

The generate(length, type) takes two optional parameters:

length: the desired length ,int, of the random string. type: the type of generated string, string, and it take one of the following string values

  • int: numbers
  • lwr: Lowercase
  • upr: uppercase
  • uln: Uppercase, LowerCase and Numbers
  • urs: URL safe
  • hex: Hexadecimal
  • mix: Mix of Special Characters and alphanumerical.

Notice: The default value and the minimum of the length parameter is 4. The default value of type parameter is mix

Version 2.0.0 and Major changes

  • The basic type int is renamed to num and new basic type int(min,max) is added where min and max are integers and this type is a random integer between the two values. e.g. int(0,255) is a random integer between 0 and 255.

  • Custom Fox Patterns to customize the format of the generated random string based on the basic types and these custom strings has type named cus

  • New type non is introduced to faciliate adding static format and contents to the string such as sperators, symbols, etc

Fox Patterns

Instead of passing basic types such as lwr and hex as a type of required string, Fox Patterns come with handy utility to format and shape the generated string to what ever you need based on available basic types. For example:

let type = '[int(0,255)]3{<.>!}(4)[non]1{<:>}(1)[int(0,65535)]4{<*>!}(1)';
let length = 4 // any filler integer
let rand = Object.create('FoxRandomString');
output = rand.generate(length,type);
console.log(output);
// The output is a string of a random IP4 address with a random port.
type = '[hex]8{<->L}(1)[hex]4{<->L}(3)[hex]12{<->!L}(1)';
// Fox Pattern for UUID like string
console.log(length,type);

In other words, Fox Patterns turns types into patterns.

Fox Pattern consists of portions each portion consists of 4 major custom patterns. For example, the Fox Pattern of UUID, starts with [hex] a basic type name between square brackets, followed by an integer 8 that says make the type hex generated has the length 8 characters. It followed by curly brackets {} which contain the separator - between <-> and other optional formating Flags outside <> in this case it is L which means change the string to lower case and finally we see an integer between two braces (1) it tells make this pattern once.

The next portion [hex]4{<->L}(3) almost the same but here we said repeat the pattern three times (3). The final portion [hex]12{<->!L}(1) also the same as the first with a change that we said 12 Hexadecimal characters in length with the formating flag !L which tells turn the string into lowercase and ! say not place the separator at the last generated pattern of that portion.

General rules and notes about Fox Pattern

  • It should has no any white spaces between portions or between patterns inside the portion.
  • It should be written in the same order. i.e. [Type between square brackets]Integer{<Separator>Flags}(Number of repeatation)

It is also available as NPM package

npm i foxrandomstring

New in version 2.1.0

-Adding new flag PSxPS and PExPE where x any padding string. PS stands for padding start, while PE padding end. These flags introduced to provide padding to the generated string for example:

let type = '[int(0,255)]3{<.>!}(4)'
//it should generate random integer between 0 and 255 with length 3 characters. However, if the string is, for example, 21! 
type = '[int(0,255)]3{<.>!PS0PS}(4)'
// padding the string to reach 3 with 0. i.e 21 will be 021

-Fixing Type Casting issue in int generator.

New in version 2.2.0

Adding new custom type array, in which, it could randomely select among a predefined array indices. It follows the pattern below:

// Array to random select from its indices
var varName = ['John','Doe','Ali', 'Sandra','Jim','Romio','Randa'];
let type = '[arr-varName]1{< >}(2)';
let rand = Object.create('FoxRandomString');
//In some conditions, eval does not work, so you have to define the property arr of the object by the array itself
rand.arr = varName;
console.log(rand.generate(4,type));

Demo of the old version jsbin demo

Another most recent demo on livecodes.io

foxrandomstring.js's People

Contributors

saidbakr avatar hatemhosny avatar

Watchers

 avatar

Forkers

hatemhosny

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.