Feature/show different tempalte options

sample/src/App.fsproj

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFrameworks>net6.0;net7.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <IsPackable>false</IsPackable>
   </PropertyGroup>
@@ -16,4 +16,4 @@
     <Content Include="js-file.js" />
   </ItemGroup>
   <Import Project="..\..\.paket\Paket.Restore.targets" />
-</Project>
+</Project>

src/Perla/CliMiddleware.fs

@@ -296,7 +296,8 @@ module Middleware =
           env.RunSetupTemplates(
             {
               fullRepositoryName =
-                $"{Default_Templates_Repository}:{Default_Templates_Repository_Branch}"
+                Some
+                  $"{Default_Templates_Repository}:{Default_Templates_Repository_Branch}"
               operation = RunTemplateOperation.Add
             },
             cancellationToken

src/Perla/CliMiddleware.fsi

@@ -79,6 +79,7 @@ module Middleware =
         bool
 
     val ToSCLMiddleware: middleware: PerlaCliMiddleware -> InvocationMiddleware
+
     val previewCheck:
       command: Command * directives: KeyValuePair<string, string seq> seq ->
         Task<Result<unit, PerlaMdResult>>

src/Perla/Commands.fs

@@ -294,13 +294,13 @@ module PackageInputs =
   let showAsNpm: HandlerInput<bool option> =
     Input.OptionMaybe(
       [ "--npm"; "--as-package-json"; "-j" ],
-      "Show the packages simlar to npm's package.json"
+      "Show the packages similar to npm's package.json"
     )
 
 [<RequireQualifiedAccess>]
 module TemplateInputs =
-  let repositoryName: HandlerInput<string> =
-    Input.Argument(
+  let repositoryName: HandlerInput<string option> =
+    Input.ArgumentMaybe(
       "templateRepositoryName",
       "The User/repository name combination"
     )
@@ -332,12 +332,6 @@ module ProjectInputs =
   let projectName: HandlerInput<string> =
     Input.Argument("name", "Name of the new project")
 
-  let templateName: HandlerInput<string option> =
-    Input.OptionMaybe(
-      [ "-tn"; "--template-name" ],
-      "repository/directory combination of the template name, or the full name in case of name conflicts username/repository/directory"
-    )
-
   let byId: HandlerInput<string option> =
     Input.OptionMaybe(
       [ "-id"; "--group-id" ],
@@ -719,7 +713,7 @@ module Commands =
     let buildArgs
       (
         ctx: InvocationContext,
-        name: string,
+        name: string option,
         add: bool option,
         update: bool option,
         remove: bool option,
@@ -786,13 +780,11 @@ module Commands =
       (
         ctx: InvocationContext,
         name: string,
-        template: string option,
         byId: string option,
         byShortName: string option
       ) : ProjectOptions * CancellationToken =
       {
         projectName = name
-        byTemplateName = template
         byId = byId
         byShortName = byShortName
       },
@@ -807,7 +799,6 @@ module Commands =
       inputs (
         Input.Context(),
         ProjectInputs.projectName,
-        ProjectInputs.templateName,
         ProjectInputs.byId,
         ProjectInputs.byShortName
       )

src/Perla/Commands.fsi

@@ -59,7 +59,7 @@ module PackageInputs =
 
 [<RequireQualifiedAccess>]
 module TemplateInputs =
-  val repositoryName: HandlerInput<string>
+  val repositoryName: HandlerInput<string option>
   val addTemplate: HandlerInput<bool option>
   val updateTemplate: HandlerInput<bool option>
   val removeTemplate: HandlerInput<bool option>
@@ -68,7 +68,6 @@ module TemplateInputs =
 [<RequireQualifiedAccess>]
 module ProjectInputs =
   val projectName: HandlerInput<string>
-  val templateName: HandlerInput<string option>
   val byId: HandlerInput<string option>
   val byShortName: HandlerInput<string option>
 

src/Perla/Configuration.fsi

@@ -59,17 +59,29 @@ module internal ConfigExtraction =
   module FromDecoders =
     open Json.ConfigDecoders
 
-    val GetFable: FableConfig option * DecodedFableConfig option -> FableConfig option
-    val GetDevServer: DevServerConfig * DecodedDevServer option -> DevServerConfig option
+    val GetFable:
+      FableConfig option * DecodedFableConfig option -> FableConfig option
+
+    val GetDevServer:
+      DevServerConfig * DecodedDevServer option -> DevServerConfig option
+
     val GetBuild: BuildConfig * DecodedBuild option -> BuildConfig option
-    val GetEsbuild: EsbuildConfig * DecodedEsbuild option -> EsbuildConfig option
+
+    val GetEsbuild:
+      EsbuildConfig * DecodedEsbuild option -> EsbuildConfig option
+
     val GetTesting: TestConfig * DecodedTesting option -> TestConfig option
 
   [<RequireQualifiedAccess>]
   module FromFields =
-    val GetServerFields: DevServerConfig * DevServerField seq option -> DevServerField seq
+    val GetServerFields:
+      DevServerConfig * DevServerField seq option -> DevServerField seq
+
     val GetMinify: RunConfiguration * DevServerField seq -> bool
-    val GetDevServerOptions: DevServerConfig * DevServerField seq -> DevServerConfig
+
+    val GetDevServerOptions:
+      DevServerConfig * DevServerField seq -> DevServerConfig
+
     val GetTesting: TestConfig * TestingField seq option -> TestConfig
 
   val FromEnv: config: PerlaConfig -> PerlaConfig

src/Perla/FileSystem.fs

@@ -243,8 +243,7 @@ module FileSystem =
         let extract () =
           use stream = new GZipInputStream(File.OpenRead path)
 
-          use archive =
-            TarArchive.CreateInputTarArchive(stream, Encoding.UTF8)
+          use archive = TarArchive.CreateInputTarArchive(stream, Encoding.UTF8)
 
           path |> Path.GetDirectoryName |> archive.ExtractContents
 

src/Perla/FileSystem.fsi

@@ -54,7 +54,9 @@ module FileSystem =
   val TplRepositoryChildTemplates:
     path: string<SystemPath> -> string<SystemPath> seq
 
-  val DotNetToolRestore: cancellationToken: CancellationToken -> Task<Result<unit, string>>
+  val DotNetToolRestore:
+    cancellationToken: CancellationToken -> Task<Result<unit, string>>
+
   val CheckFableExists: cancellationToken: CancellationToken -> Task<bool>
 
 [<Class>]

src/Perla/Handlers.fs

@@ -95,13 +95,12 @@ type RunTemplateOperation =
   | List of ListFormat
 
 type TemplateRepositoryOptions = {
-  fullRepositoryName: string
+  fullRepositoryName: string option
   operation: RunTemplateOperation
 }
 
 type ProjectOptions = {
   projectName: string
-  byTemplateName: string option
   byId: string option
   byShortName: string option
 }
@@ -188,13 +187,7 @@ module Templates =
       let table =
         Table()
           .AddColumns(
-            [|
-              "Name"
-              "Group"
-              "Belongs to"
-              "Parent Location"
-              "Last Update"
-            |]
+            [| "Name"; "perla new -t"; "perla new -id"; "Repository name" |]
           )
 
       for column in table.Columns do
@@ -204,51 +197,37 @@ module Templates =
         let name: Rendering.IRenderable =
           Markup($"[bold green]{template.name}[/]")
 
-        let group = Markup($"[bold yellow]{template.group}[/]")
-        let belongsTo = Markup($"[bold blue]{parent.ToFullNameWithBranch}[/]")
-
-        let lastUpdate =
-          parent.updatedAt
-          |> Option.ofNullable
-          |> Option.defaultValue parent.createdAt
-          |> (fun x -> $"[bold green]{x.ToShortDateString()}[/]")
-          |> Markup
-
-        let location =
-          TextPath(
-            UMX.untag parent.path,
-            LeafStyle = Style(Color.Green),
-            StemStyle = Style(Color.Yellow),
-            SeparatorStyle = Style(Color.Blue)
-          )
+        let shortname = Markup($"[bold yellow]{template.shortName}[/]")
+        let group = Markup($"[bold blue]{template.group}[/]")
 
-        table.AddRow([| name; group; belongsTo; location; lastUpdate |])
-        |> ignore
+        let repositoryName =
+          Markup($"[bold blue]{parent.ToFullNameWithBranch}[/]")
+
+        table.AddRow([| name; shortname; group; repositoryName |]) |> ignore
 
       AnsiConsole.Write table
       0
     | ListFormat.TextOnly ->
-      let columns =
-        Columns([| "Name"; "Group"; "Belongs to"; "Parent Location" |])
+      let columns = Columns([| "Name"; "perla new -t"; "perla new -id" |])
 
       AnsiConsole.Write columns
 
       let rows = [|
         for parent, template in results do
           let name = Markup($"[bold green]{template.name}[/]")
-          let group = Markup($"[bold yellow]{template.group}[/]")
+          let shortname = Markup($"[bold yellow]{template.shortName}[/]")
+          let group = Markup($"[bold blue]{template.group}[/]")
 
-          let belongsTo = Markup($"[bold blue]{parent.ToFullNameWithBranch}[/]")
-
-          let location =
+          let repositoryName =
             TextPath(
-              UMX.untag parent.path,
+              UMX.untag parent.ToFullNameWithBranch,
               LeafStyle = Style(Color.Green),
               StemStyle = Style(Color.Yellow),
               SeparatorStyle = Style(Color.Blue)
             )
 
-          Columns(name, group, belongsTo, location) :> Rendering.IRenderable
+          Columns(name, shortname, group, repositoryName)
+          :> Rendering.IRenderable
       |]
 
       rows |> Rows |> AnsiConsole.Write
@@ -591,14 +570,10 @@ module Handlers =
       |> Option.map UMX.tag<TemplateGroup>
       |> Option.map QuickAccessSearch.Group
 
-    let inline byTemplateName () =
-      options.byTemplateName |> Option.map QuickAccessSearch.Name
-
     let queryParam =
       options.byShortName
       |> Option.map QuickAccessSearch.ShortName
       |> Option.orElseWith byId
-      |> Option.orElseWith byTemplateName
 
     let foundRepo = result {
       let! query = queryParam |> Result.requireSome Templates.NoQueryParams
@@ -773,15 +748,25 @@ module Handlers =
       }
 
       let updateRepo () = task {
-        let template = template.Value
-        Logger.log $"Template {template.ToFullNameWithBranch} already exists."
+        match template with
+        | ValueSome template ->
+          Logger.log $"Template {template.ToFullNameWithBranch} already exists."
+
+          match!
+            Templates.AddOrUpdate(Templates.TemplateOperation.Update template)
+          with
+          | Ok() -> return 0
+          | Error err ->
+            Logger.log (err, escape = false)
+            return 1
+        | ValueNone ->
+          Logger.log "We were unable to parse the repository name."
+
+          Logger.log (
+            "please ensure that the repository name is in the format: [bold blue]username/repository:branch[/]",
+            escape = false
+          )
 
-        match!
-          Templates.AddOrUpdate(Templates.TemplateOperation.Update template)
-        with
-        | Ok() -> return 0
-        | Error err ->
-          Logger.log (err, escape = false)
           return 1
       }
 

src/Perla/Handlers.fsi

@@ -62,13 +62,12 @@ type RunTemplateOperation =
   | List of ListFormat
 
 type TemplateRepositoryOptions = {
-  fullRepositoryName: string
+  fullRepositoryName: string option
   operation: RunTemplateOperation
 }
 
 type ProjectOptions = {
   projectName: string
-  byTemplateName: string option
   byId: string option
   byShortName: string option
 }
@@ -94,12 +93,12 @@ type DescribeOptions = {
 
 [<Struct>]
 type PathOperation =
-  | AddOrUpdate of addImport: string<BareImport> * addPath: string<ResolutionUrl>
+  | AddOrUpdate of
+    addImport: string<BareImport> *
+    addPath: string<ResolutionUrl>
   | Remove of removeImport: string
 
-type PathsOptions = {
-  operation: PathOperation
-}
+type PathsOptions = { operation: PathOperation }
 
 module Handlers =
 

src/Perla/Library.fs

@@ -5,6 +5,7 @@ open Spectre.Console.Rendering
 open FSharp.UMX
 open Perla.Units
 open Perla.PackageManager.Types
+open FsToolkit.ErrorHandling
 
 module private ImportMap =
 
@@ -75,15 +76,18 @@ module Lib =
       ValueSome(Provider.Unpkg, name, $"{version}{preview}")
     | _ -> ValueNone
 
-  let parseFullRepositoryName (value: string) =
+  let parseFullRepositoryName (value: string option) = voption {
+    let! name = value
     let regex = Regex(@"^([-_\w\d]+)\/([-_\w\d]+):?([\w\d-_]+)?$")
 
-    match value with
-    | ParseRegex regex [ username; repository; branch ] ->
-      ValueSome(username, repository, branch)
-    | ParseRegex regex [ username; repository ] ->
-      ValueSome(username, repository, "main")
-    | _ -> ValueNone
+    return!
+      match name with
+      | ParseRegex regex [ username; repository; branch ] ->
+        ValueSome(username, repository, branch)
+      | ParseRegex regex [ username; repository ] ->
+        ValueSome(username, repository, "main")
+      | _ -> ValueNone
+  }
 
   let getTemplateAndChild (templateName: string) =
     match

src/Perla/Library.fsi

@@ -20,7 +20,7 @@ module Lib =
     url: string -> (Provider * string * string) voption
 
   val internal parseFullRepositoryName:
-    value: string -> (string * string * string) voption
+    value: string option -> (string * string * string) voption
 
   val internal getTemplateAndChild:
     templateName: string -> string option * string * string option

src/Perla/Properties/launchSettings.json

@@ -88,6 +88,11 @@
       "commandName": "Project",
       "commandLineArgs": "add @esm-bundle/chai -d",
       "workingDirectory": "$(ProjectDir)/../../sample"
+    },
+    "Show templates in table": {
+      "commandName": "Project",
+      "commandLineArgs": "t foo -ls table",
+      "workingDirectory": "$(ProjectDir)/../../sample"
     }
   }
 }