- major refactor changes:

- move exercises to a root folder
- move solution method at the top
- move paras after examples
- change path of algs4-data
- change desc for note
- minor updates in comments

Author: Isaac Ramirez

docs/samples/ex-x.x.x.js

@@ -41,7 +41,6 @@ class C1S1E1 {
 
 // Exports
 // ==============================
-
 module.exports = C1S1E1
 
 // Bash Execution

src/exercises/chap-1/section-1/ex-1.1.1.js renamed to exercises/chapter/01/section/01/ex-1.1.1.js

@@ -1,21 +1,9 @@
-const { StdOut } = require('../../../libs')
+const { StdOut } = require('../../../../../src/libs')
 
 /**
  * Exercise 1.1.1
  */
 class Exercise {
-  static a () {
-    return (0 + 15) / 2
-  }
-
-  static b () {
-    return 2.0e-6 * 100000000.1
-  }
-
-  static c () {
-    return true && false || true && true // eslint-disable-line
-  }
-
   /**
    * Solution Exercise 1.1.1
    * @example
@@ -31,10 +19,24 @@ class Exercise {
     StdOut.println(`b) ${Exercise.b()}`)
     StdOut.println(`c) ${Exercise.c()}`)
   }
+
+  static a () {
+    return (0 + 15) / 2
+  }
+
+  static b () {
+    return 2.0e-6 * 100000000.1
+  }
+
+  static c () {
+    return true && false || true && true // eslint-disable-line
+  }
 }
 
+// Exports
+// ==============================
 module.exports = Exercise
 
-// Execution
+// Bash Execution
 // ==============================
 if (require.main === module) Exercise.solution()

src/exercises/chap-1/section-1/ex-1.1.10.js renamed to exercises/chapter/01/section/01/ex-1.1.10.js

@@ -1,4 +1,4 @@
-const { StdOut } = require('../../../libs')
+const { StdOut } = require('../../../../../src/libs')
 
 /**
  * Exercise 1.1.10
@@ -23,8 +23,10 @@ class Exercise {
   }
 }
 
+// Exports
+// ==============================
 module.exports = Exercise
 
-// Execution
+// Bash Execution
 // ==============================
 if (require.main === module) Exercise.solution()

src/exercises/chap-1/section-1/ex-1.1.11.js renamed to exercises/chapter/01/section/01/ex-1.1.11.js

@@ -1,9 +1,33 @@
-const { StdOut, StdRandom } = require('../../../libs')
+const { StdOut, StdRandom } = require('../../../../../src/libs')
 
 /**
  * Exercise 1.1.11
  */
 class Exercise {
+  /**
+   * Solution Exercise 1.1.11
+   * @example
+   * ```shell
+   * $ node ex-1.1.11.js 5 5
+   *   1  2  3  4  5
+   * 1 *        *
+   * 2    *     *
+   * 3    *  *  *  *
+   * 4       *  *  *
+   * 5 *  *        *
+   * ```
+   * @param {[]} args [x, y] Cols, Rows
+   */
+  static solution (args) {
+    const x = parseInt(args[0], 10)
+    const y = parseInt(args[1], 10)
+
+    const m = this.createMatrix(x, y)
+    const sm = this.matrixToString(m)
+
+    StdOut.println(sm)
+  }
+
   /**
    * Returns a matrix of `x` columns
    * and `y` rows with random boolean values.
@@ -55,34 +79,12 @@ class Exercise {
 
     return cols + s
   }
-
-  /**
-   * Solution Exercise 1.1.11
-   * @param {[]} args [x, y] Cols, Rows
-   * @example
-   * ```shell
-   * $ node ex-1.1.11.js 5 5
-   *   1  2  3  4  5
-   * 1 *        *
-   * 2    *     *
-   * 3    *  *  *  *
-   * 4       *  *  *
-   * 5 *  *        *
-   * ```
-   */
-  static solution (args) {
-    const x = parseInt(args[0], 10)
-    const y = parseInt(args[1], 10)
-
-    const m = this.createMatrix(x, y)
-    const sm = this.matrixToString(m)
-
-    StdOut.println(sm)
-  }
 }
 
+// Exports
+// ==============================
 module.exports = Exercise
 
-// Execution
+// Bash Execution
 // ==============================
 if (require.main === module) Exercise.solution(process.argv.slice(2))

src/exercises/chap-1/section-1/ex-1.1.12.js renamed to exercises/chapter/01/section/01/ex-1.1.12.js

@@ -1,4 +1,4 @@
-const { StdOut } = require('../../../libs')
+const { StdOut } = require('../../../../../src/libs')
 
 /**
  * Exercise 1.1.12
@@ -27,8 +27,10 @@ class Exercise {
   }
 }
 
+// Exports
+// ==============================
 module.exports = Exercise
 
-// Execution
+// Bash Execution
 // ==============================
 if (require.main === module) Exercise.solution()

src/exercises/chap-1/section-1/ex-1.1.13.js renamed to exercises/chapter/01/section/01/ex-1.1.13.js

@@ -1,26 +1,12 @@
-const { StdOut, StdRandom, Matrix } = require('../../../libs')
-const { newArrayOf } = require('../../../utils')
+const { StdOut, StdRandom, Matrix } = require('../../../../../src/libs')
+const { newArrayOf } = require('../../../../../src/utils')
 
 /**
  * Exercise 1.1.13
  */
 class Exercise {
-  /**
-   * Creates a matrix of `x` · `y`
-   * of random integer numbers.
-   * @param {number} x Number of Cols
-   * @param {number} y Number of Rows
-   * @returns {[[]]} A matrix of `x` columns and `y` rows
-   */
-  static createMatrix (x, y) {
-    return newArrayOf(y, () => {
-      return newArrayOf(x, () => StdRandom.uniform(Math.max(x, y)))
-    })
-  }
-
   /**
    * Solution Exercise 1.1.13
-   * @param {[]} args [x, y] Cols, Rows
    * @example
    * ```shell
    * $ node ex-1.1.13.js 4 3
@@ -35,6 +21,7 @@ class Exercise {
    * 2,0,0
    * 3,2,1
    * ```
+   * @param {[]} args [x, y] Cols, Rows
    */
   static solution (args) {
     const x = parseInt(args[0], 10)
@@ -50,10 +37,25 @@ class Exercise {
     StdOut.println('[after]')
     StdOut.println(t.join('\n'))
   }
+
+  /**
+   * Creates a matrix of `x` · `y`
+   * of random integer numbers.
+   * @param {number} x Number of Cols
+   * @param {number} y Number of Rows
+   * @returns {[[]]} A matrix of `x` columns and `y` rows
+   */
+  static createMatrix (x, y) {
+    return newArrayOf(y, () => {
+      return newArrayOf(x, () => StdRandom.uniform(Math.max(x, y)))
+    })
+  }
 }
 
+// Exports
+// ==============================
 module.exports = Exercise
 
-// Execution
+// Bash Execution
 // ==============================
 if (require.main === module) Exercise.solution(process.argv.slice(2))

src/exercises/chap-1/section-1/ex-1.1.14.js renamed to exercises/chapter/01/section/01/ex-1.1.14.js

@@ -1,14 +1,49 @@
-const { StdOut } = require('../../../libs')
+const { StdOut } = require('../../../../../src/libs')
 
 /**
  * Exercise 1.1.14
  */
 class Exercise {
+  /**
+   * Solution Exercise 1.1.14
+   * @example <caption>my initial implementation</caption>
+   * ```shell
+   * $ node ex-1.1.14.js 123456789
+   * 123456789 -> 26
+   * ```
+   * @example <caption>alternative implementation</caption>
+   * ```shell
+   * $ node ex-1.1.14.js 123456789 -v2
+   * [v2]
+   * 123456789 -> 26
+   * ```
+   * @example <caption>math implementation</caption>
+   * ```shell
+   * $ node ex-1.1.14.js 123456789 -math
+   * [math]
+   * 123456789 -> 26
+   * ```
+   * @param {[]} args [n, -v] Integer number, version
+   */
+  static solution (args) {
+    const n = parseInt(args[0], 10)
+    const version = args[1]
+
+    if (version === '-v2') {
+      StdOut.println('[v2]')
+      StdOut.println('%d -> %d', n, this.lgV2(n))
+    } else if (version === '-math') {
+      StdOut.println('[math]')
+      StdOut.println('%d -> %d', n, this.lgMath(n))
+    } else {
+      StdOut.println('%d -> %d', n, this.lg(n))
+    }
+  }
+
   /**
    * Calculates the largest integer
    * not larger than the `base-2` logarithm of `n`.
-   * @desc
-   * <em>NOTE: this is my original implementation.</em>
+   * @note This is my original implementation.</em>
    * @param {number} n Integer number
    * @returns {number} Integer not larger than `lg_2(n)`
    */
@@ -27,8 +62,7 @@ class Exercise {
 
   /**
    * Alternative to `lg`.
-   * @desc
-   * <em>NOTE: I was curious about other implementations.</em>
+   * @note I was curious about other implementations.</em>
    * @see {@link https://stackoverflow.com/questions/53972220/calculating-the-largest-int-less-than-the-base-2-log-of-n}
    * @param {number} n Integer number
    * @returns {number} Integer not larger than `lg_2(n)`
@@ -45,57 +79,20 @@ class Exercise {
 
   /**
    * `lg` implementation using `Math`
-   * @desc
-   * <em>
-   * NOTE: The book states not to use the `Math` library!.<br>
+   * @note The book states not to use the `Math` library!.<br>
    * I'm doing it for testing purposes only.
-   * </em>
    * @param {number} n Integer number
    * @returns {number} Integer not larger than `lg_2(n)`
    */
   static lgMath (n) {
     return Math.floor(Math.log2(n))
   }
-
-  /**
-   * Solution Exercise 1.1.14
-   * @param {[]} args [n, -v] Integer number, version
-   * @example <caption>my initial implementation</caption>
-   * ```shell
-   * $ node ex-1.1.14.js 123456789
-   * 123456789 -> 26
-   * ```
-   * @example <caption>alternative implementation</caption>
-   * ```shell
-   * $ node ex-1.1.14.js 123456789 -v2
-   * [v2]
-   * 123456789 -> 26
-   * ```
-   * @example <caption>math implementation</caption>
-   * ```shell
-   * $ node ex-1.1.14.js 123456789 -math
-   * [math]
-   * 123456789 -> 26
-   * ```
-   */
-  static solution (args) {
-    const n = parseInt(args[0], 10)
-    const version = args[1]
-
-    if (version === '-v2') {
-      StdOut.println('[v2]')
-      StdOut.println('%d -> %d', n, this.lgV2(n))
-    } else if (version === '-math') {
-      StdOut.println('[math]')
-      StdOut.println('%d -> %d', n, this.lgMath(n))
-    } else {
-      StdOut.println('%d -> %d', n, this.lg(n))
-    }
-  }
 }
 
+// Exports
+// ==============================
 module.exports = Exercise
 
-// Execution
+// Bash Execution
 // ==============================
 if (require.main === module) Exercise.solution(process.argv.slice(2))