#18

Author: aplteam

APLSource/Admin/Make.aplf

@@ -7,7 +7,7 @@
      cfg←M.GetPackageCfg C.HOME
      M.FetchLaterUserCommand'Cider_UC.dyalog'cfg C('[MyUCMDs]Cider')
      M.RecreateFolder path
-     version←cfg M.CompileVersionNumberPattern C.HOME
+     version←M.CompileVersionNumberPattern cfg
      zipFilename←⎕SE.Tatin.BuildPackage C.HOME path version
      ⎕←'*** New version build successfully:',M.CR,'   ',zipFilename
      :If 1 M.YesOrNo'Install new version in MyUCMDs?'

APLSource/Cider/Cider.aplc

@@ -9,7 +9,11 @@
 
     ∇ r←Version
       :Access Public Shared
-      r←'0.23.3+367'
+      r←'0.23.4+367'
+      ⍝ * 0.23.4 ⋄ 2023-03-08
+      ⍝   * Bug fix: Cider now checks whether Tatin is available in ⎕se. If it's not it attempts to execute
+      ⍝     Tatin's "Version" function: that should force Tatin into ⎕SE
+      ⍝   * The documentation regarding the relationship between Cider and tatin has been clarified
       ⍝ * 0.23.3 ⋄ 2023-03-03
       ⍝   * Bug fix: Cider did not attempt to load its packages in case they are not found in ⎕SE in case
       ⍝     a Cider user command is executed by the user.

APLSource/Cider_uc.dyalog

@@ -1,7 +1,7 @@
-:Class Cider_UC
+:Class Cider_UC
 ⍝ User Command class for the project manager "Cider"
 ⍝ Kai Jaeger
-⍝ 2023-03-03
+⍝ 2023-03-08
 
     ⎕IO←1 ⋄ ⎕ML←1 ⋄ ⎕WX←3
     MinimumVersionOfDyalog←'18.0'
@@ -96,6 +96,13 @@
       :Access Shared Public
       r←0 0⍴''
       ('Cider needs at least version ',MinimumVersionOfDyalog,' of Dyalog APL')Assert AtLeastVersion⊃(//)⎕VFI MinimumVersionOfDyalog
+      :If 0=⎕SE.⎕NC'Tatin'
+          :Trap 6
+              {}⎕SE.UCMD'Tatin.Version'
+          :Else
+              'Tatin is not available and cannot be loaded into ⎕SE, therefore Cider won''t work'Assert 0
+          :EndTrap
+      :EndIf
       :If 0=⎕SE.⎕NC'Cider'
           {}⎕SE.Tatin.LoadDependencies(⊃⎕NPARTS ##.SourceFile)'⎕SE'
       :EndIf

apl-package.json

@@ -1 +1 @@
-{  api: "Cider",  assets: "html",  description: "A project manager for Dyalog APL that cooperates with Tatin",  documentation: "",  files: "cider.config.template",  group: "aplteam",  io: 1,  license: "MIT",  lx: "Init",  maintainer: "kai@aplteam.com",  minimumAplVersion: "18.0",  ml: 1,  name: "Cider",  os_lin: 1,  os_mac: 1,  os_win: 1,  project_url: "https://github.com/aplteam/Cider",  source: "APLSource/Cider/",  tags: "project-management",  userCommandScript: "APLSource/Cider_UC.dyalog",  version: "0.23.3+375",}
+{  api: "Cider",  assets: "html",  description: "A project manager for Dyalog APL that cooperates with Tatin",  documentation: "",  files: "cider.config.template",  group: "aplteam",  io: 1,  license: "MIT",  lx: "Init",  maintainer: "kai@aplteam.com",  minimumAplVersion: "18.0",  ml: 1,  name: "Cider",  os_lin: 1,  os_mac: 1,  os_win: 1,  project_url: "https://github.com/aplteam/Cider",  source: "APLSource/Cider/",  tags: "project-management",  userCommandScript: "APLSource/Cider_UC.dyalog",  version: "0.23.4+376",}

docs/Cider-User-Guide.md

@@ -21,6 +21,15 @@ The two most important commands of Cider's user commands are `CreateProject` and
 
 I> Note that in this document names stemming from the Cider configuration file are shown `like this`.
 
+### Requirements
+
+Cider relies on the [Tatin packet manager](https://github.com/aplteam/Tatin "Link to Tatin on GitHub") because it is a Tatin package. With version 19.0 and later Tatin will be available in `⎕SE` right from the start. With earlier versions (18.0 and 18.2) it's up to the user to take care of that.
+
+If Tatin is not in `⎕SE` but available in the `MyUCMDs/` folder then Cider will attempt to load it by executing the user command `]Tatin.Version which should implicitly load Tatin into `⎕SE`.
+
+I> Note that Tatin will check whether Cider is available, and if so cooperate with it. However, Cider is not a requirement for Tatin.
+
+
 ### CreateProject
 
 With `]Cider.CreateProject` any folder that does not yet host a file `cider.config` can be transformed into a Cider project. (You may specify the `-acceptConfig` flag to override this default behaviour and make Cider accept an already existing file `cider.config`)