@wizhut_tech/wizjs 0.0.9 → 0.1.1

package/__tests__/lang_itertools.test.js

@@ -0,0 +1,21 @@
+const t = require('tap');
+
+const { cycle, fn_cycle } = require('../src/lang/itertools.js');
+
+
+t.test('itertools/cycle', (t) => {
+    // simple integer
+    const genOne = cycle(0, 1);
+    t.equal(genOne.next().value, 0);
+    t.equal(genOne.next().value, 1);
+    t.equal(genOne.next().value, 2);
+
+    // simple floating-point
+    const genTwo = cycle(0, 0.5);
+    t.equal(genTwo.next().value, 0);
+    t.equal(genTwo.next().value, 0.5);
+    t.equal(genTwo.next().value, 1);
+    t.equal(genTwo.next().value, 1.5);
+
+    t.end();
+});

package/docs/lang_flow.md

@@ -1,3 +1,3 @@
 # Lang / flow
 
-**Still in development**
+* **if_exception(fn, fn_noexc, fn_exc)**: executes *fn*. if it throws an exception then it calls *fn_exc*, else *fn_noexc*. 

package/docs/lang_itertools.md

@@ -0,0 +1,4 @@
+# Lang / itertools
+
+* **cycle(start, step=1)**: A generator that counts from *start* with a specified *step*. Default stepping is *1*.
+* **fn_cycle(start, step=1, fn)**: A generator that counts from *start* with a specified *step*. Default stepping is *1*. For each iteration the *fn* is called. To continue to the next iteration, the *fn* should return *true*. If not the iteration breaks,. 

package/index.js

@@ -4,6 +4,10 @@ const numbers = require('./src/math/numbers.js');
 const functools = require('./src/lang/functools.js');
 const arrays = require('./src/lang/arrays.js');
 const files = require('./src/io/files.js');
+const flow = require('./src/lang/flow.js');
+const itertools = require('./src/lang/itertools.js');
+
+const { BadlyInitializedError } = require('./src/internal/exceptions.js');
 
 
 module.exports = {
@@ -13,10 +17,15 @@ module.exports = {
     lang: {
         arrays: arrays,
         singleton: singleton,
+        flow: flow,
         checks: checks,
-        functools: functools
+        functools: functools,
+        itertools: itertools
     },
     math: {
         numbers: numbers
+    },
+    exceptions: {
+        BadlyInitializedError
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wizhut_tech/wizjs",
-  "version": "0.0.9",
+  "version": "0.1.1",
   "main": "index.js",
   "devDependencies": {
     "tap": "21.1.0"

package/readme.md

@@ -14,8 +14,10 @@ Use by importing:
     lang: {
         arrays: [functions],
         checks: [functions],
+        flow: [functions],
         singleton: [functions],
-        functools: [functions]
+        functools: [functions],
+        itertools: [functions]
     },
     math: {
         numbers: [functions]
@@ -23,7 +25,7 @@ Use by importing:
 }
 ```
 
-You can also import individual functions like the following:
+You can also import individual functions like the following snippet:
 
 `const { lang: { checks : { isNil } } }  = require('@wizhut_tech/wizjs');`
 
@@ -35,10 +37,15 @@ You can also import individual functions like the following:
 
 * **Arrays** utility functions ... [[docs](docs/lang_arrays.md)]
 * **Check** utility functions ... [[docs](docs/lang_checks.md)]
-* Control-**Flow** utilities ... [[docs](docs/lang_flow.md)] -- *still in development* --
+* Control-**Flow** utilities ... [[docs](docs/lang_flow.md)]
 * **functools** ... [[docs](docs/lang_functools.md)]
+* **itertools** ... [[docs](docs/lang_itertools.md)]
 * **Singleton** hack ... [[docs](docs/lang_singleton.md)]
 
 ### Math
 
 * Utilities around **numbers** ... [[docs](docs/math_numbers.md)]
+
+## Contact
+
+This library is actively developed and maintained by [wizhut.tech](http://wizhut.tech)

package/src/internal/exceptions.js

@@ -0,0 +1,12 @@
+
+
+class BadlyInitializedError extends Error {
+    constructor(message, ...args) {
+        super(message);
+    }
+}
+
+
+module.exports = {
+    BadlyInitializedError
+};

package/src/lang/flow.js

@@ -1,17 +1,15 @@
 
 
-class TransactionItem {
-    constructor(task, fallback) {
-        this.task = task;
-        this.fallback = fallback;
-    }
-
-    async execute() {
-        
+function if_exception(fn, fn_noexc, fn_exc) {
+    try {
+        fn();
+        fn_noexc();
+    } catch (error) {
+        fn_exc(error);
     }
 }
 
 
 module.exports = {
-
+    if_exception
 };

package/src/lang/itertools.js

@@ -0,0 +1,25 @@
+
+const {toInteger} = require("../math/numbers");
+
+
+function* cycle(start=0, step=1) {
+    let iCount = toInteger(start);
+    const iStep = toInteger(step);
+
+    while (true) {
+        yield iCount;
+        iCount += step;
+    }
+}
+
+function fn_cycle(start, fn, step=1) {
+    const cycleGenerator = cycle(start, step);
+
+    while (fn(cycleGenerator.next().value)) { }
+}
+
+
+module.exports = {
+    cycle,
+    fn_cycle
+};