@brizy/readers
v1.0.3
Published
Brizy readers package
Downloads
98
Readme
Object
read
Returns the input object if it's a valid object, otherwise undefined.
readKey
Extracts a specific key from an object. Returns the corresponding value if the key exists, otherwise undefined.
Usage/Examples
import { Obj } from '@brizy/readers'
const obj = { name: "John", age: 30 };
// read
Obj.read(obj); // { name: "John", age: 30 }
Obj.read("This is a string"); // undefined
// readKey
const getName = Obj.readKey("name");
const getEmail = Obj.readKey("email");
getName(obj); // "John"
getEmail(obj); // undefined
String
read
Returns the input string or undefined.
Usage/Examples
import { Str } from '@brizy/readers'
Str.read("hello"); // "hello"
Str.read(123); // "123"
Str.read([]); // undefined
Pipe
Usage/Examples
import { pipe } from '@brizy/readers'
const add = (x: number, y: number) => x + y;
const square = (x: number) => x * x;
const increment = (x: number) => x + 1;
const compute = pipe(add, square, increment);
const result = compute(2, 3); // result is (2 + 3)^2 + 1 = 26
Number
read
Returns the input number or undefined.
Usage/Examples
import { Num } from '@brizy/readers'
Num.read("hello"); // undefined
Num.read(123); // "123"
Num.read([]); // undefined
Num.read(1.2); // 1.2
Num.read("1.2"); // 1.2
Num.read("1,2"); // undefined
Json
read
Returns the input json or undefined.
Usage/Examples
import { Json } from '@brizy/readers'
Json.read({}); // undefined
Json.read("{}"); // {}
Json.read("{\"a\":\"a\",\"n\":5}"); // { a: "a", n: 5 }
Json.read(1); // undefined
Json.read("1"); // 1
Json.read("[1,\"a\"]"); // [1, "a"]
Json.read(""); // undefined
Json.read({ a: "a" }); // undefined
Bool
read
Returns the true/false or undefined
Usage/Examples
import { Bool } from '@brizy/readers'
Bool.read("text")); //undefined
Bool.read("1,2")); // undefined
Bool.read(1)); // undefined
Bool.read(false)); // false
Bool.read(true)); // true
Bool.read(4 === 4)); // true
Bool.read(4 !== 4)); // false
Array
read
Returns the input array or undefined
readWithItemReader
Function is a higher-order reader function that takes another reader function (itemReader) and applies it to each element of the input array. It returns an array containing the results of applying the itemReader function to each element of the input array or undefined if one of itemReaders returned undefined
Usage/Examples
import { Arr, Num, Str } from '@brizy/readers'
Arr.read("[4]")); //undefined
Arr.read(1)); // undefined
Arr.read(2.3)); // undefined
Arr.read([]); // [];
Arr.read([1, 2, 3]); // [1, 2, 3]
Arr.read(["a", "b", "c"]); // ["a", "b", "c"]
Arr.read([{}, 123]); // [{}, 123]
Arr.readWithItemReader(Str.read)([]); // []
Arr.readWithItemReader(Num.read)([]); // []
Arr.readWithItemReader(Str.read)(["a", "b"]); // ["a", "b"]
Arr.readWithItemReader(Str.read)(["a", {}]); // undefined
Arr.readWithItemReader(Num.read)([1, 2, 3]); // [1, 2, 3]
Arr.readWithItemReader(Num.read)([1, "a", 2, 3]); // undefined