atscm
Source code management utilities for atvise
atscm is a node.js based utility that stores the contents of atvise projects on the file system. This has several benefits to advanced atvise developers:
- atvise project can be put under source control (e.g. using git)
- source code can be edited in external editors
- easier unit testing
- easier source code linting / static analysis
- source files can be preprocessed by using custom transformers:
- using alternate programming languages such as ES2015 JavaScript or TypeScript
- using alternate markup languages such as pug
- using templating engines such as handlebars
Installation
Prerequisite: Install node.js (version 10 or later)
How to check which version is installed
With atscm-cli
atscm can be installed via atscm-cli.
Run
npm install --global atscm-clito install atscm-cli globally. You may have to run this command as an administrator.
With atscm-cli installed run atscm init to create a new atscm project.
With npm init
Simply run npm init atscm to create a new atscm project.
Basic usage
Pulling nodes from atvise server
Running atscm pull will download all nodes from atvise server into the ./src folder inside your project.
By default only displays, serverside scripts and quickdynamics will be split into their JavaScript and SVG sources. You can specify additional transformers to use in your Project configuration file.
Pushing source files to atvise server
Running atscm push will update all nodes from the contents of your ./src folder.
Automatically watching for changes
After running atscm watch files and atvise server nodes are watched for changes. If a file changes, the file is pushed, if a node changes this node is pulled.
atscm watch is very useful if you want edit source files in an external editor but still have the ability to use atvise builder's drag and drop functionality.
Project configuration
An atscm project's configuration is stored inside the Atviseproject file inside your project root. See the Atviseproject class reference for available options.