Cider Project Manager

Cider offers some User commands that are useful to manage projects. In addition is also offers an API.

It cooperates with Tatin.

Requirements

Cider requires

• Dyalog 18.0 Unicode or better
• Link 3.0.8 or better
• The Tatin package manager (because Cider itself is a Tatin package)

Overview

These commands are available:

• ]Cider.AddNuGetDependencies
• ]Cider.AddTatinDependencies
• ]Cider.CloseProject
• ]Cider.Config
• ]Cider.CreateProject
• ]Cider.Help
• ]Cider.ListAliases
• ]Cider.ListNuGetDependencies
• ]Cider.ListOpenProjects
• ]Cider.ListTatinDependencies
• ]Cider.Make
• ]Cider.OpenProject
• ]Cider.ProjectConfig
• ]Cider.RunTests
• ]UpdateCider
• ]Cider.Version

Documentation

In this document only OpenProject is discussed in detail because that is the main command.

For all other commands only basic information is provided, but there is a document "Cider-User-Guide.html" available that discusses all features in detail.

The user command help is also pretty exhaustive.

Regarding the API there is a document "Cider-API-Reference.html" available.

Installation

In version 19.0 Cider is part of a standard installation of Dyalog, although it needs activation before it is available. Therefore you only have to worry about installing it with version 18.0 and 18.2. Cider does not run on earlier versions of Dyalog.

With version 0.23 Cider became a Tatin package. That simplifies the installation process: all you need to do is issue this command:

      ]Tatin.InstallPackages [tatin]Cider <targetFolder>

If it is installed into a folder that is scanned for user command scripts by Dyalog, then when a new instance of Dyalog is started ]Cider will be available. For an instance that was already running when Cider was installed execute ]UReset.

If it installed into a folder that is not scanned for user command scripts you need to add that folder to the cmddir parameter of SALT.

Example:

]SALT.Settings cmddir ",C:\Users\<⎕AN>\Documents\Dyalog APL 18.2 Unicode Files"

**Watch out for the , in front of the path: it means that the folder is added!**

However, the API only becomes available after any Cider user command was executed. ]Cider.Version is enough for that.

If that is not good enough for you, this article explains how to load user commands into ⎕SE at a very early stage: https://aplwiki.com/wiki/Dyalog_User_Commands

Methods

OpenProject

Parameters

Accepts an optional parameter that must be one of:

• A folder that hosts a file cider.config
• An alias that points to such a folder

If no such parameter is specified then the current directory is searched for a file cider.config.

• If such a file exists the user is asked whether she really wants to open that project

• If no such file exists then under Windows a dialog box is opened that allows the user to navigate to a Cider project

  On non-Windows platforms an error is thrown.

Actions

Once a folder is established that holds a Cider config file, the user command performs the following actions:

1. Creates the project space (namespace)

2. Sets the system variables ⎕IO and ⎕ML in the project space

3. Brings all code and variables into the project space

4. Checks whether any Tatin install folders do not actually have any packages installed but have a non-empty dependency file.

   This may happen in case the package install folders are not uploaded to, say, GitHub (.gitignore) and the project was just downloaded.

5. Asks the user whether Cider should check all Tatin packages (if there are any) for later versions

6. Loads all Tatin packages specified in the file cider.config, if any; see dependencies.tatin and dependencies_dev.tatin

7. Injects a namespace CiderConfig into the project space and...

   • populates it with the contents of the configuration file as APL arrays
   • adds a variable HOME that remembers the path the project was loaded from

8. Injects a namespace TatinVars in case the project would end up as a package

9. Checks whether the project's config file does carry a non-empty value for init. If that's the case it must be a function that is then called by Cider, typically for initializing the project

10. If there is a variable ToDo in the root of the project, and the variable is not empty, then this variable is printed to the session

11. If the project is managed by Git then Cider executes the git status command on the project folder and puts the result on view

Notes:

• The name of the project space is defined in the Cider config file, but this can be overwritten with the -projectSpace= option

• In case the dependencies.tatin and dependencies_dev.tatin parameter specifies one or more packages then the references pointing to those Tatin packages are all established in projectSpace by default.

  However, this can be overwritten by specifying a different target space by adding:

  =SubNamespace

  after the folder

  Example:

  dependencies {
     tatin: "packages"
  }
  dependencies_dev {
     tatin: "packages_dev=TestCases"
  }
  

  • All principal packages found in packages/ within the project folder are loaded into the project space because that is the default, and the default was not overwritten

  • All principal packages found in packages_dev/ within the project folder are loaded into the project's sub namespace TestCases within the project space because the default was overwritten

CloseProject

Takes one or more folders or a aliases and breaks the Link between the namespace and its folder for all of them.

Separate projects with space or commas.

You may specify the -all flag to close all projects in # (not ⎕SE!), but check the user command's detailed help (-??) for details.

CreateProject

Requires one mandatory parameter: a folder that is going to be a project.

Creates a file cider.config in that folder.

Config

Allow the user to edit Cider's global config file .

Help

Offers the user to view selected or all HTML documents with her standard browser.

AddNuGetDependencies

Use this to add NuGet dependencies

AddTatinDependencies

Use this to add Tatin (and probably also load) Tatin dependencies.

ListOpenProjects

Lists the project spaces of all currently linked projects together with the fully qualified paths of all projects currently open.

ListNuGetDependencies

Lists all NuGet dependencies of the project.

ListTatinDependencies

Lists all Tatin dependencies of the project.

ListAliases

Lists all Cider aliases together with their folders.

ProjectConfig

Puts a project's config file on display and allows the user to edit it.

Make

Prints an APL statement to the session which, when executed, will build a new version of the project.

RunTests

Prints an APL statement to the session which, when executed, runs the project's test suite.

Version

Returns a three-item-vector with "Name", "Version number" and "Version date".

UpdateCider

Update Cider in case there is a later version available.