This project contains the source code for the SASjs VS Code extension, available in the following locations:

• Visual Studio Code Marketplace (suitable for VS Code): https://marketplace.visualstudio.com/items?itemName=SASjs.sasjs-for-vscode
• Open VSX (Suitable for VSCodium and Theia): https://open-vsx.org/extension/sasjs/sasjs-for-vscode

If you have questions or would like support on the extension, visit our support group at https://matrix.to/#/#sasjs:4gl.io.

• Code Documentation
• Code Execution
• SAS Lint and Format

Generate HTML docs from your SAS code! Requires a local installation of Doxygen. Video overview available here.

Configuration is identical to the SASjs CLI, documented at https://cli.sasjs.io/doc, driven by the docConfig object.

Given that projects may be new to SASjs (without a sasjs/sasjsconfig.json file) the following workflow takes place:

1. If workspace contains a sasjs/sasjsconfig.json file, go to Step 3
2. If any parent directories contain a sasjs/sasjsconfig.json file, use this target, and go to Step 4.
3. Create a workspace-level sasjs/sasjsconfig.json file (and doxy files), and use this as the target.
4. Generate docs using target docConfig.outDirectory property (sasjsbuild/docs by default)
5. Put index.html in focus

To view the index.html as a web page, open in Firefox, or right click and view with the Live Server extension (if installed).

You can run code on SAS Viya, SAS 9 EBI or SASjs Server! Just set up the target, and click the running man to execute your SAS code.

You can also highlight a section of code and run that. Each log returned will be stored in a sasjsresults folder. You can also run the SASjs: Execute Code command from the command palette(Cmd+Shift+P).

The target 🎯 describes the server on which you intend to run the code. The attributes are added to a file in your home directory - ~/.sasjsrc. More info here).

The following attributes are needed for all server types:

• Name. An alias to represent the target.
• Server Url. The full URL (including port if needed) of your SAS server.
• Server Type. Can be SASVIYA, SAS9 or SASJS.

Below are the setup steps specific to each server type

Enter the following prompts:

• CLIENT / SECRET. Relevant for SASVIYA - you will need to ask your administrator for these, and they should have the authorization_code grant type. More info here.
• Follow the link to obtain your authorisation code

For a SAS9 server type, you need to provide your user and passsword in the prompts. Before you can execute code, you will need a runner (an STP in your metadata home directory) - just follow the instructions here: https://cli.sasjs.io/auth/#sasjs-runner

In order to run on Foundation / Base / Desktop SAS you will need a running version of SASjs server (on the same machine where SAS is installed). You can download SASjs server here. Configuration instructions are here.

For local desktop instances of SASjs Server, the serverUrl is likely to be http://localhost:5000

If you are running SASjs Server in server mode, then you will need a client id - the default is clientID1

Spend less time on code reviews and more time pushing code! Select VIEW->PROBLEMS (or ctrl+shift+M) to examine the currently opened SAS program for issues.

Rules can be configured by creating a .sasjslint file in the root of your project as follows:

{
    "defaultHeader": "/**{lineEnding}  some custom header{lineEnding}**/",
    "noEncodedPasswords": true,
    "hasDoxygenHeader": true,
    "hasMacroNameInMend": true,
    "hasMacroParentheses": true,
    "ignoreList": [
      "sajsbuild/",
      "sasjsresults/"
    ],
    "indentationMultiple": 2,
    "lowerCaseFileNames": true,
    "maxLineLength": 80,
    "noNestedMacros": true,
    "noSpacesInFileNames": true,
    "noTabIndentation": true,
    "noTrailingSpaces": true
}

SASjs lint can automatically fix certain problems within SAS files, such as trailing spaces, missing Doxygen header blocks and missing macro names in %mend statements. You can use this feature in two ways:

1. On demand - by selecting 'Format Document' either from the right click menu or from the command palette.

2. By enabling automatic formatting of files on save/paste from the Settings menu.

SASjs is an open source project, and contributions are warmly welcomed!

Thanks goes to these wonderful people (emoji key):

Allan Bowe 💻 ⚠️ 👀 📹 📖

Yury Shkoda 💻 ⚠️ 📆 📹 📖

Krishna Acondy 💻 ⚠️ 👀 🚇 📦 🚧 🖋

Muhammad Saad 💻 ⚠️ 👀 🧑‍🏫 📖

Sabir Hassan 💻 ⚠️ 👀 🤔

Mihajlo Medjedovic 💻 ⚠️ 👀 🚇

Vladislav Parhomchik ⚠️ 👀

This project follows the all-contributors specification. Contributions of any kind welcome!