Key Points

...

then pull to local repo and view in Github desktop

Change Management: Manage changes in 2 versions of an application

Git can show all the changes made in the local app code not yet published

/Users/jimmason/Documents/Github/ebc-api

>> git commit --dry-run -m 'fix trade accounting jim'

On branch dev

Your branch is up to date with 'origin/dev'.

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)

  (use "git restore <file>..." to discard changes in working directory)

 modified:   src/services/offers/offers.hooks.js

 modified:   src/services/trades/trades.hooks.js

no changes added to commit (use "git add" and/or "git commit -a")

VSCode offers timeline to view manage changes between versions locally

Select a file in Explorer > select timeline << versions listed

Select another version > compare << comparison window opens showing changes between the 2 versions

Select RB menu << menu options include:   stage selected ranges, unstage selected ranges, revert selected ranges 

Image Added

Debug Nodejs app in VSCode 

...

nodejs-tutorial-code.visualstudio-Nodejs tutorial in Visual Studio Code.pdf

Note: If you've been using the VS Code integrated terminal to install the Express generator and scaffold the app, you can open the myExpressApp folder from your running VS Code instance with the File > Open Folder command.

VSCode uses Typescript to create metadata in the app

VS Code uses TypeScript type declaration (typings) files (for example node.d.ts) to provide metadata to VS Code about the JavaScript based frameworks you are consuming in your application. Type declaration files are written in TypeScript so they can express the data types of parameters and functions, allowing VS Code to provide a rich IntelliSense experience. Thanks to a feature called Automatic Type Acquisition, you do not have to worry about downloading these type declaration files, VS Code will install them automatically for you.

Debug Nodejs app 

The debug and terminal views can be opened from the View menus

...

https://code.visualstudio.com/docs/nodejs/nodejs-debugging

The Visual Studio Code editor has built-in debugging support for the Node.js runtime and can debug JavaScript, TypeScript, and many other languages that are transpiled into JavaScript. Setting up a project for Node.js debugging is straightforward with VS Code providing appropriate launch configuration defaults and snippets.

There are a few ways you can debug your Node.js programs in VS Code:

• Use auto attach to debug process you run in VS Code's integrated terminal,
• Use the JavaScript debug terminal, in a similar way, or
• Use a launch config to start your program, or attach to a process launched outside of VS Code

Auto-Attach for Debug 

If the Auto Attach feature is enabled, the Node debugger automatically attaches to certain Node.js processes that have been launched from VS Code's Integrated Terminal. To enable the feature, either use the Toggle Auto Attach command from the command palette (F1) or, if it's already activated, use the Auto Attach Status bar item.

There are three modes for auto attach, which you can select in the resulting Quick Pick and via the debug.javascript.autoAttachFilter setting:

• smart (default) - If you execute a script outside of your node_modules folder or use a common 'runner' script like mocha or ts-node, the process will be debugged. You can configure the 'runner' script allow list using the Auto Attach Smart Pattern setting (debug.javascript.autoAttachSmartPattern).
• always - All Node.js processes launched in the Integrated Terminal will be debugged.
• onlyWithFlag - Only processes launched with the --inspect or --inspect-brk flag will be debugged.

After enabling Auto Attach, you'll need to restart your terminal. This can be done by clicking the ⚠ icon in the top right of the terminal, or just creating a new one. Then, the debugger should attach to your program within a second:

When auto attach is on, the Auto Attach item will appear in the status bar across the bottom of the VS Code window. Clicking it allows you to change the auto attach mode, or temporarily turn it off. Temporarily turning off auto attach is useful if you're running some one-off programs where you don't need debugging, but you don't want to disable the feature entirely.

Additional Configuration#

Other Launch Configuration Properties

You can apply other properties normally found in launch.json to auto attach in the debug.javascript.terminalOptions setting. For example, to add node internals to your skipFiles, you could add the following to your user or workspace settings:

  "debug.javascript.terminalOptions": {
    "skipFiles": [
      "<node_internals>/**"
    ]
  },

Auto Attach Smart Patterns

In smart Auto Attach mode, VS Code will try to attach to your code, and not attach to build tools you aren't interested in debugging. It does this by matching the main script against a list of glob patterns. The glob patterns are configurable in the debug.javascript.autoAttachSmartPattern setting, which defaults to:

[
  '!**/node_modules/**', // exclude scripts in node_modules folders
  '**/$KNOWN_TOOLS$/**' // but include some common tools
];

$KNOWN_TOOLS$ is replaced list a list of common 'code runners' such as ts-node, mocha, ava, and so on. You can modify this list if these settings don't work. For example, to exclude mocha and include my-cool-test-runner, you could add two lines:

[ '!**/node_modules/**', '**/$KNOWN_TOOLS$/**', '!**/node_modules/mocha/**', // use "!" to exclude all scripts in "mocha" node modules '**/node_modules/my-cool-test-runner/**'// include scripts in the custom test runner ];

Javascript Debug Terminal

In a similar way to auto attach, the JavaScript Debug Terminal will automatically debug any Node.js process you run in it. You can create a Debug Terminal by running the use the Debug: Create JavaScript Debug Terminal command from the command palette (F1), or by selecting the Create JavaScript Debug Terminal from the terminal switcher dropdown.

Image Modified

Additional Configuration#

Other Launch Configuration Properties

You can apply other properties normally found in launch.json to the debug terminal in the debug.javascript.terminalOptions setting. For example, to add node internals to your skipFiles, you could add the following to your user or workspace settings:

"debug.javascript.terminalOptions": {
  "skipFiles": [
    "<node_internals>/**"
  ]
},

Launch Configuration#

Launch configs are the traditional way to set up debugging in VS Code, and provide you the most configuration options for running complex applications.

In this section we'll go into more detail about configurations and features for more advanced debugging scenarios. You'll find instruction for debugging with source maps, stepping over external code, doing remote debugging, and much more.

If you'd like to watch an introductory video, see Getting started with Node.js debugging.

Note: If you are just getting started with VS Code, you can learn about general debugging features and creating launch.json configuration files in the Debugging topic.

Launch configuration attributes#

Debugging configurations are stored in a launch.json file located in your workspace's .vscode folder. An introduction into the creation and use of debugging configuration files is in the general Debugging article.

Below is a reference of common launch.json attributes specific to the Node.js debugger. You can view the complete set of options in the vscode-js-debug options documentation.

The following attributes are supported in launch configurations of type launch and attach:

• outFiles - array of glob patterns for locating generated JavaScript files. See section Source maps.
• resolveSourceMapLocations - an array of glob patterns for locations where source maps should be parsed. See section Source maps.
• timeout - when restarting a session, give up after this number of milliseconds. See section Attaching to Node.js.
• stopOnEntry - break immediately when the program launches.
• localRoot - VS Code's root directory. See section Remote debugging below.
• remoteRoot - Node's root directory. See section Remote debugging below.
• smartStep- try to automatically step over code that doesn't map to source files. See section Smart stepping.
• skipFiles - automatically skip files covered by these glob patterns. See section Skipping uninteresting code.
• trace - enable diagnostic output.

These attributes are only available for launch configurations of request type launch:

• program - an absolute path to the Node.js program to debug.
• args - arguments passed to the program to debug. This attribute is of type array and expects individual arguments as array elements.
• cwd - launch the program to debug in this directory.
• runtimeExecutable - absolute path to the runtime executable to be used. Default is node. See section Launch configuration support for 'npm' and other tools.
• runtimeArgs - optional arguments passed to the runtime executable.
• runtimeVersion - if "nvm" (or "nvm-windows") or "nvs" is used for managing Node.js versions, this attribute can be used to select a specific version of Node.js. See section Multi version support below.
• env - optional environment variables. This attribute expects environment variables as a list of string typed key/value pairs.
• envFile - optional path to a file containing environment variable definitions. See section Load environment variables from external file below.
• console - the console to launch the program (internalConsole, integratedTerminal, externalTerminal). See section Node Console below.
• outputCapture - if set to std, output from the process stdout/stderr will be shown in the Debug Console, instead of listening to output over the debug port. This is useful for programs or log libraries that write directly to the stdout/stderr streams instead of using console.* APIs.

This attribute is only available for launch configurations of request type attach:

• restart - restart the connection on termination. See section Restarting debug session automatically.
• protocol - debug protocol to use. See section Supported Node-like runtimes above.
• port - debug port to use. See sections Attaching to Node.js and Remote debugging.
• address - TCP/IP address of the debug port. See sections Attaching to Node.js and Remote debugging.
• processId - the debugger tries to attach to this process after having sent a USR1 signal. With this setting, the debugger can attach to an already running process that was not started in debug mode. When using the processId attribute, the debug port is determined automatically based on the Node.js version (and the used protocol) and cannot be configured explicitly. So don't specify a port attribute.
• continueOnAttach - whether to continue the process if it's paused when we attach to it. This option is useful if you launch your program with --inspect-brk.

Launch configurations for common scenarios#

You can trigger IntelliSense (⌃Space) in your launch.json file to see launch configuration snippets for commonly used Node.js debugging scenarios.

Image Modified

You can also bring up the snippets with the Add Configuration... button in the lower right of the launch.json editor window.

Thomas - Feathersjs ebc-api  debug with Postman and VSCode 

...