@wizhut_tech/wizjs 0.0.7 → 0.0.9

package/docs/io_files.md

@@ -0,0 +1,3 @@
+# Lang / files
+
+* **loadFully(filename)**: loads a *file*, fully and returns it as text. If an error occurs return null 

package/docs/lang_arrays.md

@@ -1,2 +1,3 @@
 # Lang / Arrays
 
+* *compact(arg)*: removes *null* and *undefined* values from an array, returns always an array. If the *arg* is invalid, it returns an empty array. 

package/index.js

@@ -3,9 +3,13 @@ const checks = require('./src/lang/checks.js');
 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');
 
 
 module.exports = {
+    io: {
+        files: files,
+    },
     lang: {
         arrays: arrays,
         singleton: singleton,

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@wizhut_tech/wizjs",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "main": "index.js",
   "devDependencies": {
-    "tap": "21.0.2"
+    "tap": "21.1.0"
   },
   "description": "Simple but useful hacks for everyday javascript programming",
   "scripts": {

package/readme.md

@@ -8,6 +8,9 @@ Use by importing:
 
 ```
 {
+    io: {
+        files: [functions]
+    },
     lang: {
         arrays: [functions],
         checks: [functions],
@@ -20,6 +23,14 @@ Use by importing:
 }
 ```
 
+You can also import individual functions like the following:
+
+`const { lang: { checks : { isNil } } }  = require('@wizhut_tech/wizjs');`
+
+### I/O
+
+* **Files** utility functions ... [[docs](docs/io_files.md)]
+
 ### Language
 
 * **Arrays** utility functions ... [[docs](docs/lang_arrays.md)]

package/src/io/files.js

@@ -0,0 +1,15 @@
+const fs = require('fs').promises;
+
+
+async function loadFully(filename) {
+    try {
+        const data = await fs.readFile(filename, 'utf8');
+    } catch (err) {
+        return null;
+    }
+}
+
+
+module.exports = {
+    loadFully
+};