SASjs CLI

@sasjs/cli is a Command-Line Interface to assist with creating, building, and deploying Data Science projects and HTML5 Web Applications on the SAS platform (both SAS 9 and Viya). Features include:

• Scaffold a new SAS App in seconds (sasjs create myApp -t jobs)
• Compile / Build SAS Jobs, Services & Macros locally and deploy / execute remotely, in isolation from other developers (sasjs cbd)
• Build and deploy without recompiling - for when the services on disk are already the ones you want to ship (sasjs bd)
• Compile a single Job, Service or Test without touching the rest of the build (sasjs compile identify --source sasjs/jobs/daily/load.sas)
• Write the test coverage report to sasjsbuild/coverage.json on every compile, ready for a CI job to publish
• No dependency on the server filesystem
• Optionally synchronise a local folder onto the server filesystem using sasjs fs
• Trigger Viya Jobs & Flows (sasjs job execute / sasjs flow execute)
• Enforce code quality rules with sasjs lint
• Check what SAS actually printed, and fail a pipeline on it, with sasjs logcheck - the same check reports the log of run, request, job execute and flow execute, and can fail those commands too via logCheck.autoCheck
• Generate HTML5 documentation (requires doxygen) with sasjs doc
• Create and execute SAS tests (sasjs test)

There is also a feature to let you deploy a frontend application as a set of streaming web services, bypassing the need to deploy to the SAS Web Server.

A quick demonstration of using it to compile, build and deploy a set of SAS Viya jobs is shown below.

Installation

1. Install globally using npm as follows:

  npm i -g @sasjs/cli

You can also use the tool without deploying through NPX as follows:

npx @sasjs/cli <command>

Documentation

Additional documentation can be found on the SASjs CLI documentation site.

Notes

Running npm i -g @sasjs/cli@latest does not always upgrade properly. This is due to a known bug in npm, which is fixed in npm 7.

If you are running NPM in version 6 or below, you can try running npm update -g @sasjs/cli instead, or - the sledgehammer approach - delete the files from the NPM folder and then do a fresh install.

Contributing

See CONTRIBUTING.md for local setup.

Star Gazing

If you find this library useful, please leave a star and help us grow our star graph!

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Muhammad Saad 💻 ⚠️ 👀 🧑‍🏫 📖	Yury Shkoda 💻 📆 ⚠️ 📹 📖	Krishna Acondy 💻 ⚠️ 🚇 🖋 🚧 📦 👀	Mihajlo Medjedovic 💻 🚇 ⚠️ 👀	Allan Bowe 💻 👀 ⚠️ 📹 📖	Sabir Hassan 💻 👀 ⚠️ 🤔	VladislavParhomchik ⚠️ 👀
Rud Faden 🐛	Sead Mulahasanović 💻	Trevor Moody 💻

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