initial setup and version 1.0.0 complete

Author: bbgrabbag

.eslintrc.json

@@ -0,0 +1,14 @@
+{
+    "env": {
+        "browser": true,
+        "commonjs": true,
+        "es2021": true,
+        "jest": true
+    },
+    "extends": "eslint:recommended",
+    "parserOptions": {
+        "ecmaVersion": 12
+    },
+    "rules": {
+    }
+}

.gitignore

@@ -0,0 +1 @@
+node_modules

.vscode/launch.json

@@ -0,0 +1,25 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "name": "Unit Test",
+            "request": "launch",
+            "program": "${workspaceFolder}/node_modules/.bin/jest",
+            "args": [
+                "--runInBand",
+                "--watchAll=false"
+            ],
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal",
+            "internalConsoleOptions": "neverOpen",
+            "disableOptimisticBPs": true,
+            "windows": {
+                "program": "${workspaceFolder}/node_modules/jest/bin/jest"
+            }
+        }
+    ]
+}

README.md

@@ -0,0 +1,66 @@
+# V School Code Talk Challenges
+
+### About
+- A playground Node.js environment for testing and debugging pure, single functions. 
+- Useful for running local debugger and creating custom test cases for code puzzles from Edabit, Code Wars, etc. 
+
+### Getting Started
+- `npm install`
+- `npm run test`
+- In VS Code, you can run the debugger using the Jest configuration called `Unit Test` listed in `.vscode/launch.json` file. Hotkey is F5. This will automatically read the `jest.config.js` file
+
+### Creating Custom Challenges
+- Within `/challenges` directory, create a file which contains a default export of the function you wish to test. For example:
+```js
+// challenges/add_func.js
+module.exports = (x, y) => { return x + y };
+```
+
+- In `test-cases.js` add a property (using same name as the file created above) to the default export object which defines an array containing the set of inputs and expected values. Each test case should look something like this:
+
+```js
+// test-cases.js
+module.exports = {
+    add_func: [
+        [
+            // arguments to be passed the 'add_func' function:
+            [1, 2], 
+            // expected output of the 'add_func' function:
+            3
+        ],
+        [[0, 0], 0],
+        [[-1, -2], -3],
+    ],
+    // etc...
+}
+```
+
+### Testing Single Challenges
+- To run tests for all cases defined for a given challenge, set the property `globals.testSingleChallenge` within `jest.config.js` to the name of the file you wish to test as defined in `/challenges` (omit the `.js` extension). For example: 
+```js
+// jest.config.js
+module.exports = {
+    globals: {
+        testSingleChallenge: "example"
+    },
+    //...
+}
+```
+
+### Testing Single Test Cases
+- To run a test on a single test case for a given challenge, set the property `globals.testSingleTestCase` within `jest.config.js` to the index of the test case you wish to try. The property `globals.testSingleChallenge` must also be defined. For example: 
+```js
+// jest.config.js
+module.exports = {
+    globals: {
+        testSingleChallenge: "example",
+        testSingleTestCase: 0
+    },
+    // ...
+}
+```
+
+### [Changelog](./changelog.md)
+
+### Author
+- Reach out to [Ben Turner](bbgrabbag@gmail.com) for any questions, bugs, or contribution requests.

challenges/example.js

@@ -0,0 +1 @@
+module.exports = (val) => val;

changelog.md

@@ -0,0 +1,3 @@
+ #### *v1.0.0* **10/3/2021**
+- Initial release
+- Introduced ability to test single challenges and test cases via Jest config

jest.config.js

@@ -0,0 +1,24 @@
+/*
+ * For a detailed explanation regarding each configuration property, visit:
+ * https://jestjs.io/docs/configuration
+ */
+
+module.exports = {
+  // A set of global variables that need to be available in all test environments
+  globals: {
+    // If defined, jest will only run tests on the function exported from this file (omit file extension) as defined in the directory '/challenges':
+
+    // testSingleChallenge: 'example',
+
+    // If defined, jest will only run test on the specified test case index. Will do nothing if the above property 'testSingleChallenge' is not also defined.
+
+    // testSingleTestCase: 0
+  },
+
+  // Automatically clear mock calls and instances between every test
+  clearMocks: true,
+
+  // Indicates which provider should be used to instrument code for coverage
+  coverageProvider: "v8",
+
+};

main.js

@@ -0,0 +1,8 @@
+const fs = require('fs');
+
+const files = fs.readdirSync('./challenges');
+
+files.forEach(file => {
+    const challenge = file.replace('.js', '');
+    module.exports[challenge] = require('./challenges/' + file);
+});

main.test.js

@@ -0,0 +1,33 @@
+const { testCases } = require("./test-cases");
+const functions = require("./main");
+
+const testCaseKeys = Object.keys(testCases);
+const functionKeys = Object.keys(functions);
+
+try {
+  for (const k of testCaseKeys) {
+    if (!functionKeys.includes(k))
+      throw Error(`No function found for test case '${k}'`);
+  }
+  for (const k of functionKeys) {
+    if (!testCaseKeys.includes(k))
+      throw Error(`No test case found for function '${k}()'`);
+    const describer =
+      global.testSingleChallenge === k
+        ? fdescribe
+        : describe;
+    describer(`Unit testing function '${k}()'`, () => {
+      testCases[k].forEach(([inputs, expected], i) => {
+        const runner =
+        global.testSingleChallenge === k && global.testSingleTestCase === i
+            ? fit
+            : it;
+        runner(`Should output correct value for test case '${i}'`, () => {
+          expect(functions[k](...inputs)).toEqual(expected);
+        });
+      });
+    });
+  }
+} catch (e) {
+  console.error(e.message);
+}