embedded python demo

Author: evshvarov

README.md

@@ -1,16 +1,22 @@
-## 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
+## iris-embedded-python-template
+This is a template to work with Embedded Python in InterSystems IRIS
 
 ## 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 
+
+## Installation ZPM
+
+```
+USER>zpm "install iris-python-template"
+```
+
+## Installation docker
 
 Clone/git pull the repo into any local directory
 
 ```
-$ git clone https://github.com/intersystems-community/objectscript-docker-template.git
+$ git clone https://github.com/intersystems-community/iris-embedded-python-template.git
 ```
 
 Open the terminal in this directory and run:
@@ -25,40 +31,33 @@ $ docker-compose build
 $ docker-compose up -d
 ```
 
-## How to Test it
+## How to work with it
 
 Open IRIS terminal:
 
 ```
 $ docker-compose exec iris iris session iris
-USER>write ##class(dc.PackageSample.ObjectScript).Test()
+USER>
 ```
-## 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.
+The first test demonstrates the call to a standard python library working with dates datetime
+```
+USER>d ##class(dc.python.test).Today()
+2021-02-09
+```
 
+Another example shows the work of a custom lib sample.py which is installed with repo or ZPM. It has function hello which returns string "world":
+```
+USER>d ##class(dc.python.test).Hello()
+World
+```
 
-### .vscode/settings.json
+Another example shows how to work with files and use pandas and numpy libs. 
+It calculates the mean age of Titanic passengers:
 
-Settings file to let you immedietly code in VSCode with [VSCode ObjectScript plugin](https://marketplace.visualstudio.com/items?itemName=daimor.vscode-objectscript))
+```
+USER>d ##class(dc.python.test).TitanicMeanAge()
+mean age=29.69911764705882
 
-### .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)