Get started
Install and activate Cider; create and open a blank project
Install
Dyalog version 19.0 has Tatin and Cider already installed. Nothing to do here.
For Dyalog v18.2 install Tatin and Cider
For Dyalog v18.2, first install Tatin.
Then use Tatin to install Cider.
]Tatin.InstallPackages [tatin]Cider <targetFolder>
where <targetFolder> is
C:\Users\<⎕AN>\Documents\Dyalog APL 18.2 Unicode Files\SessionExtensions\CiderTatin\Cider
C:\Users\<⎕AN>\Documents\Dyalog APL-64 18.2 Unicode Files\SessionExtensions\CiderTatin\Cider
/home/<⎕AN>/dyalog.182U64.files/SessionExtensions/CiderTatin/Cider/
/Users/<⎕AN>/dyalog.182U64.files/SessionExtensions/CiderTatin/Cider/
Activate
Dyalog v19.0 installs with Tatin and Cider, but they are disabled by default.
]Activate all
Rebuild the user commands.
]UReset
Restart Dyalog.
Verify. For example,
]TATIN.Version
Tatin 0.112.1+1942 2024-08-16
]CIDER.Version
0.42.2+671
Your first Cider user command also activates the Cider API.
Create a blank project
]CIDER.CreateProject <projectpath>
where <projectpath> identifies a folder that is empty or does not exist.
Cider creates the folder as a Cider project, with an empty APLSource child folder, linked to a new namespace in your active workspace.
]CIDER.CreateProject /Users/sjt/tmp/myproj
"/Users/sjt/tmp/myproj" does not exist yet - create? (Y/n) Y
Project successfully created; open as well? (Y/n) Y
Link parameter "watch" is <both>
The current directory is now /Users/sjt/tmp/myproj
No Dropbox conflicts found
Project successfully opened and established in "#.myproj"
Now Link will save APL objects in the #.myproj namespace as text files in APLSource.
)CS myproj
#.myproj
mean←{(+⌿÷≢)⍵}
]LINK.Add mean
Added: #.myproj.mean
❯ tree myproj
myproj
├── APLSource
│ └── mean.aplf
└── cider.config
Open your project
Clear the workspace and open the project.
)CLEAR
clear ws
]CIDER.OpenProject /Users/sjt/tmp/myproj
Link parameter "watch" is <both>
The current directory is now /Users/sjt/tmp/myproj
No Dropbox conflicts found
Project successfully opened and established in "#.myproj"
myproj.mean ⍳20
10.5
Changes to the objects in #.myproj will be mirrored in their source files in myproj/APLSource.
Changes to the source files will be mirrored in the workspace.
When you quit Dyalog your changes have already been saved.
If you have APL source files already written, copy them into the APLSource folder.