Initial commit

.dockerignore

@@ -0,0 +1,2 @@
+**/.DS_Store
+.git

.gitattributes

@@ -0,0 +1,5 @@
+*.sh text eol=lf
+*.cls text eol=lf
+*.mac text eol=lf
+*.int text eol=lf
+Dockerfil* text eol=lf

.github/workflows/objectscript-quality.yml

@@ -0,0 +1,12 @@
+name: objectscriptquality
+on: push
+
+jobs:
+  linux:
+    name: Linux build
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Execute ObjectScript Quality Analysis
+      run: wget https://raw.githubusercontent.com/litesolutions/objectscriptquality-jenkins-integration/master/iris-community-hook.sh && sh ./iris-community-hook.sh
+

.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+
+

.vscode/launch.json

@@ -0,0 +1,18 @@
+{
+    "version": "0.2.0",
+    "configurations": [    
+      {
+        "type": "objectscript",
+        "request": "launch",
+        "name": "ObjectScript Debug Class", 
+        "program": "##class(PackageSample.ObjectScript).Test()",
+      },
+      {
+        "type": "objectscript",
+        "request": "attach",
+        "name": "ObjectScript Attach",
+        "processId": "${command:PickProcess}",
+        "system": true
+      }
+    ]
+  }

.vscode/settings.json

@@ -0,0 +1,33 @@
+{
+    "files.associations": {
+
+        "Dockerfile*": "dockerfile",
+        "iris.script": "objectscript"
+      },
+    "objectscript.conn" :{
+      "ns": "USER",
+      "username": "_SYSTEM",
+      "password": "SYS",
+      "docker-compose": {
+        "service": "iris",
+        "internalPort": 52773
+      },
+      "active": true
+    },
+    "sqltools.connections": [
+      {
+        "namespace": "USER",
+        "connectionMethod": "Server and Port",
+        "showSystem": false,
+        "previewLimit": 50,
+        "server": "localhost",
+        "port": 32770,
+        "askForPassword": false,
+        "driver": "InterSystems IRIS",
+        "name": "objectscript-docker",
+        "username": "_SYSTEM",
+        "password": "SYS"
+      }
+    ]
+
+}

Dockerfile

@@ -0,0 +1,23 @@
+ARG IMAGE=store/intersystems/iris-community:2020.1.0.204.0
+ARG IMAGE=intersystemsdc/iris-community:2020.1.0.209.0-zpm
+ARG IMAGE=intersystemsdc/iris-community:2020.2.0.204.0-zpm
+ARG IMAGE=intersystemsdc/irishealth-community:2020.3.0.200.0-zpm
+ARG IMAGE=intersystemsdc/iris-community:2020.3.0.200.0-zpm
+ARG IMAGE=intersystemsdc/iris-community:2020.3.0.221.0-zpm
+ARG IMAGE=intersystemsdc/iris-community:2020.4.0.524.0-zpm
+FROM $IMAGE
+
+USER root   
+
+WORKDIR /opt/irisbuild
+RUN chown ${ISC_PACKAGE_MGRUSER}:${ISC_PACKAGE_IRISGROUP} /opt/irisbuild
+USER ${ISC_PACKAGE_MGRUSER}
+
+#COPY  Installer.cls .
+COPY  src src
+COPY module.xml module.xml
+COPY iris.script iris.script
+
+RUN iris start IRIS \
+	&& iris session IRIS < iris.script \
+    && iris stop IRIS quietly

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 InterSystems Developer Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,64 @@
+## intersystems-objectscript-template
+This is a template for InterSystems ObjectScript Github repository.
+The template goes also with a few files which let you immedietly compile your ObjecScript 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.PackageSample.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.
+![docker_compose](https://user-images.githubusercontent.com/2781759/76656929-0f2e5700-6547-11ea-9cc9-486a5641c51d.gif)
+
+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 immedietly 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 artilce](https://community.intersystems.com/post/dockerfile-and-friends-or-how-run-and-collaborate-objectscript-projects-intersystems-iris)

dev.md

@@ -0,0 +1,61 @@
+# useful commands
+## clean up docker 
+use it when docker says "There is no space left on device". It will remove built but not used images and other temporary files.
+```
+docker system prune -f
+```
+
+## build container with no cache
+```
+docker-compose build --no-cache
+```
+## start iris container
+```
+docker-compose up -d
+```
+
+## open iris terminal in docker
+```
+docker-compose exec iris iris session iris -U IRISAPP
+```
+
+## install docker-compose
+```
+sudo curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+
+sudo chmod +x /usr/local/bin/docker-compose
+
+```
+
+## select zpm test registry
+```
+repo -n registry -r -url https://test.pm.community.intersystems.com/registry/ -user test -pass PassWord42
+```
+
+## get back to public zpm registry
+```
+repo -r -n registry -url https://pm.community.intersystems.com/
+```
+
+## export a global in runtime into the repo
+```
+d $System.OBJ.Export("GlobalD.GBL","/irisrun/repo/src/gbl/GlobalD.xml")
+```
+
+## create a web app in dockerfile
+```
+zn "%SYS" \
+  write "Create web application ...",! \
+  set webName = "/csp/irisweb" \
+  set webProperties("NameSpace") = "IRISAPP" \
+  set webProperties("Enabled") = 1 \
+  set webProperties("CSPZENEnabled") = 1 \
+  set webProperties("AutheEnabled") = 32 \
+  set webProperties("iKnowEnabled") = 1 \
+  set webProperties("DeepSeeEnabled") = 1 \
+  set sc = ##class(Security.Applications).Create(webName, .webProperties) \
+  write "Web application "_webName_" has been created!",! 
+```
+
+zw ##class(community.csvgen).GenerateFromURL("https://github.com/h2oai/h2o-tutorials/raw/master/h2o-world-2017/automl/data/product_backorders.csv")
+

docker-compose.yml

@@ -0,0 +1,13 @@
+version: '3.6'
+services:
+  iris:
+    build: 
+      context: .
+      dockerfile: Dockerfile
+    restart: always
+    ports: 
+      - 1972
+      - 52773
+      - 53773
+    volumes:
+      - ./:/irisrun/repo

iris.script

@@ -0,0 +1,8 @@
+;do $System.OBJ.LoadDir("/opt/irisbuild/src","ck",,1)
+
+zn "%SYS"
+Do ##class(Security.Users).UnExpireUserPasswords("*")
+
+zn "USER"
+zpm "load /opt/irisbuild/ -v":1:1
+halt

module.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Export generator="Cache" version="25">
+  <Document name="objectscript-template.ZPM">
+    <Module>
+      <Name>objectscript-template</Name>
+      <Version>1.1.2</Version>
+      <Packaging>module</Packaging>
+      <SourcesRoot>src</SourcesRoot>
+      <Resource Name="dc.PackageSample.PKG"/>
+    </Module>
+  </Document>
+</Export>

src/dc/PackageSample/ObjectScript.cls

@@ -0,0 +1,10 @@
+Class dc.PackageSample.ObjectScript
+{
+
+ClassMethod Test() As %Status
+{
+    set a=42
+    return "It works!"
+}
+
+}

src/dc/PackageSample/PersistentClass.cls

@@ -0,0 +1,31 @@
+Class dc.PackageSample.PersistentClass Extends %Persistent
+{
+
+Property Test As %VarString;
+
+ClassMethod CreateRecord() As %Status
+{
+    s objPC=..%New()
+    s objPC.Test="Test string"
+    return objPC.%Save()
+}
+
+Storage Default
+{
+<Data name="PersistentClassDefaultData">
+<Value name="1">
+<Value>%%CLASSNAME</Value>
+</Value>
+<Value name="2">
+<Value>Test</Value>
+</Value>
+</Data>
+<DataLocation>^dc.Package4C8F.PersistentC1A93D</DataLocation>
+<DefaultData>PersistentClassDefaultData</DefaultData>
+<IdLocation>^dc.Package4C8F.PersistentC1A93D</IdLocation>
+<IndexLocation>^dc.Package4C8F.PersistentC1A93I</IndexLocation>
+<StreamLocation>^dc.Package4C8F.PersistentC1A93S</StreamLocation>
+<Type>%Storage.Persistent</Type>
+}
+
+}