https://github.com/intersystems-community/objectscript-docker-template
Template project for InterSystems ObjectScript with InterSystems IRIS community Edition docker container
https://github.com/intersystems-community/objectscript-docker-template
docker intersystems intersystems-iris objectscript template
Last synced: about 1 month ago
JSON representation
Template project for InterSystems ObjectScript with InterSystems IRIS community Edition docker container
- Host: GitHub
- URL: https://github.com/intersystems-community/objectscript-docker-template
- Owner: intersystems-community
- License: mit
- Created: 2019-09-03T15:56:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-06-27T11:53:24.000Z (8 months ago)
- Last Synced: 2025-06-27T12:29:20.204Z (8 months ago)
- Topics: docker, intersystems, intersystems-iris, objectscript, template
- Language: ObjectScript
- Homepage:
- Size: 63.5 KB
- Stars: 30
- Watchers: 7
- Forks: 17
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## intersystems-objectscript-template
This is a template for InterSystems ObjectScript Github repository.
The template goes also with a few files which let you immediately compile your ObjectScript files in InterSystems IRIS Community Edition in a docker container
## Prerequisites
Make sure you have [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) and [Docker desktop](https://www.docker.com/products/docker-desktop) installed.
## Installation
Clone/git pull the repo into any local directory
```
$ git clone https://github.com/intersystems-community/objectscript-docker-template.git
```
Open the terminal in this directory and run:
```
$ docker-compose build
```
3. Run the IRIS container with your project:
```
$ docker-compose up -d
```
## How to Test it
Open IRIS terminal:
```
$ docker-compose exec iris iris session iris
USER>write ##class(dc.sample.ObjectScript).Test()
```
## How to start coding
This repository is ready to code in VSCode with ObjectScript plugin.
Install [VSCode](https://code.visualstudio.com/), [Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) and [ObjectScript](https://marketplace.visualstudio.com/items?itemName=daimor.vscode-objectscript) plugin and open the folder in VSCode.
Open /src/cls/PackageSample/ObjectScript.cls class and try to make changes - it will be compiled in running IRIS docker container.
Feel free to delete PackageSample folder and place your ObjectScript classes in a form
/src/Package/Classname.cls
[Read more about folder setup for InterSystems ObjectScript](https://community.intersystems.com/post/simplified-objectscript-source-folder-structure-package-manager)
The script in Installer.cls will import everything you place under /src into IRIS.
## What's inside the repository
### Dockerfile
The simplest Dockerfile which starts IRIS and imports code from /src folder into it.
Use the related docker-compose.yml to easily setup additional parametes like port number and where you map keys and host folders.
### .vscode/settings.json
Settings file to let you immediately code in VSCode with [VSCode ObjectScript plugin](https://marketplace.visualstudio.com/items?itemName=daimor.vscode-objectscript))
### .vscode/launch.json
Config file if you want to debug with VSCode ObjectScript
[Read about all the files in this article](https://community.intersystems.com/post/dockerfile-and-friends-or-how-run-and-collaborate-objectscript-projects-intersystems-iris)