feat(python): initial release

Taskfile.yaml

@@ -6,3 +6,5 @@ vars:
 
 includes:
   dotnet: sdks/dotnet/Taskfile.yaml
+  node: sdks/node/Taskfile.yaml
+  python: sdks/python/Taskfile.yaml

nix/env.nix

@@ -21,10 +21,16 @@ with packages;
   ];
 
   main = [
+    python
+    poetry
+
     go
+
     dotnet
+
     nodejs
     bun
+
     infisical
   ];
 

nix/packages.nix

@@ -42,21 +42,24 @@ let
 
           # dotnet
           xmlstarlet
+          # go
+          golangci-lint
+          go
+
 
           #infra
           docker;
 
+        python = python312;
+        poetry = (poetry.override { python3 = python311; });
+
         npm = nodePackages.npm;
         nodejs = nodejs_20;
       }
     );
     sep-04-23 = (
       with pkgs-sep-04-23;
       {
-        inherit
-          # go
-          golangci-lint
-          go;
         dotnet = dotnet-sdk_8;
       }
     );

scripts/ci/publish.sh

@@ -2,10 +2,18 @@
 
 set -eou pipefail
 
+og="$(pwd)"
+
 echo "🚀 Publishing .NET package"
 ./sdks/dotnet/scripts/ci/publish.sh
+cd "${og}" || exit
+
+echo "🚀 Publishing Python package"
+./sdks/python/scripts/ci/publish.sh
+cd "${og}" || exit
 
 echo "🚀 Publishing npm package"
 ./sdks/node/scripts/ci/publish.sh
+cd "${og}" || exit
 
 echo "✅ All packages published"

scripts/ci/update_version.sh

@@ -8,3 +8,5 @@ echo "🤜 Updating .NET version to ${version}"
 ./sdks/dotnet/scripts/ci/update_version.sh "${version}"
 echo "🤜 Updating Node version to ${version}"
 ./sdks/node/scripts/ci/update_version.sh "${version}"
+echo "🤜 Updating Python version to ${version}"
+./sdks/python/scripts/ci/update_version.sh "${version}"

sdks/dotnet/cyan.yaml

@@ -0,0 +1,11 @@
+username: ernest
+name: dotnet-handlebar
+description: .NET Handlebar to process templates
+project: https://github.com/tr8team/template.nestjs
+source: https://github.com/tr8team/template.nestjs
+email: ernest@tr8.io
+tags:
+  - dotnet
+  - handlerbar
+  - csharp
+readme: README.MD

sdks/dotnet/sulfone-helium-processor-api/Program.cs

@@ -19,15 +19,15 @@
     Console.WriteLine("HandleBarsConfig: {0}", handleBarsConfig.ToJson());
 
     var files = fileHelper.ResolveAll();
-
+    var handlebars = Handlebars.CreateSharedEnvironment(new HandlebarsConfiguration { TextEncoder = null });
     var parsed = files.Select(x =>
     {
         try
         {
             return x with
             {
-                BaseWrite = Handlebars.Compile(x.BaseWrite)(handleBarsConfig?.Vars ?? new Dictionary<string, string>()),
-                Content = Handlebars.Compile(x.Content)(handleBarsConfig?.Vars ?? new Dictionary<string, string>())
+                Relative = handlebars.Compile(x.Relative)(handleBarsConfig?.Vars ?? new Dictionary<string, string>()),
+                Content = handlebars.Compile(x.Content)(handleBarsConfig?.Vars ?? new Dictionary<string, string>())
             };
         }
         catch (Exception e)

sdks/dotnet/sulfone-helium/Api/Core/CoreMapper.cs

@@ -8,18 +8,18 @@ public static class CyanMapper
 {
     public static CyanPlugin ToDomain(this CyanPluginReq req)
     {
-
         return new CyanPlugin
         {
             Name = req.Name,
-            Config = req.Config.ToDynamic(), 
+            Config = req.Config.ToDynamic(),
         };
     }
 
     public static CyanGlob ToDomain(this CyanGlobReq req)
     {
         return new CyanGlob
         {
+            Root = req.Root,
             Glob = req.Glob,
             Exclude = req.Exclude,
             Type = req.Type switch
@@ -96,6 +96,7 @@ public static CyanGlobRes ToResp(this CyanGlob data)
     {
         return new CyanGlobRes()
         {
+            Root = data.Root,
             Glob = data.Glob,
             Exclude = data.Exclude,
             Type = data.Type.ToResp(),

sdks/dotnet/sulfone-helium/Api/Core/CyanReq.cs

@@ -4,6 +4,7 @@ namespace sulfone_helium.Api.Core;
 
 public struct CyanGlobReq
 {
+    public string? Root { get; init; }
     public string Glob { get; init; }
     public string[] Exclude { get; init; }
     public string Type { get; init; }

sdks/dotnet/sulfone-helium/Api/Core/CyanRes.cs

@@ -4,6 +4,7 @@ namespace sulfone_helium.Api.Core;
 
 public struct CyanGlobRes
 {
+    public string? Root { get; init; }
     public string Glob { get; init; }
     public string[] Exclude { get; init; }
     public string Type { get; init; }

sdks/dotnet/sulfone-helium/Domain/Core/Cyan.cs

@@ -8,6 +8,7 @@ public enum GlobType
 
 public class CyanGlob
 {
+    public string? Root { get; init; }
     public required string Glob { get; init; }
     public required string[] Exclude { get; init; }
     public required GlobType Type { get; init; }
@@ -30,6 +31,4 @@ public class Cyan
 {
     public required IEnumerable<CyanProcessor> Processors { get; init; }
     public required IEnumerable<CyanPlugin> Plugins { get; init; }
-
-}
-
+}

sdks/dotnet/sulfone-helium/Domain/Core/FileSystem/CyanFileHelper.cs

@@ -42,28 +42,34 @@ public IEnumerable<VirtualFileStream> ReadAsStream(CyanGlob glob)
         matcher.AddIncludePatterns(new[] { glob.Glob });
         matcher.AddExcludePatterns(glob.Exclude);
 
-        var matchingFiles = matcher.GetResultsInFullPath(this.ReadDir)
-            .Select(x => Path.GetRelativePath(this.ReadDir, x))
+        var globRoot = this.GlobDir(glob);
+
+        var matchingFiles = matcher.GetResultsInFullPath(globRoot)
+            .Select(x => Path.GetRelativePath(globRoot, x))
             .ToArray();
         return matchingFiles.Select(x =>
             new VirtualFileStream(
-                File.OpenText(Path.Combine(this.ReadDir, x)),
+                File.OpenText(Path.Combine(globRoot, x)),
                 File.CreateText(Path.Combine(this.WriteDir, x))
             )
         );
     }
 
+    private string GlobDir(CyanGlob glob) => Path.Combine(this.ReadDir, glob.Root ?? ".");
+
     public IEnumerable<VirtualFileReference> Get(CyanGlob glob)
     {
         Matcher matcher = new();
         matcher.AddIncludePatterns(new[] { glob.Glob });
         matcher.AddExcludePatterns(glob.Exclude);
 
-        var matchingFiles = matcher.GetResultsInFullPath(this.ReadDir)
-            .Select(x => Path.GetRelativePath(this.ReadDir, x))
+        var globRoot = this.GlobDir(glob);
+        var matchingFiles = matcher.GetResultsInFullPath(globRoot)
+            .Select(x => Path.GetRelativePath(globRoot, x))
             .ToArray();
+
         return matchingFiles.Select(x =>
-            new VirtualFileReference(this.ReadDir, this.WriteDir, x)
+            new VirtualFileReference(globRoot, this.WriteDir, x)
         );
     }
 
@@ -78,12 +84,14 @@ public void Copy(CyanGlob copy)
         matcher.AddIncludePatterns(new[] { copy.Glob });
         matcher.AddExcludePatterns(copy.Exclude);
 
-        var matchingFiles = matcher.GetResultsInFullPath(this.ReadDir)
-            .Select(x => Path.GetRelativePath(this.ReadDir, x))
+        var globRoot = this.GlobDir(copy);
+
+        var matchingFiles = matcher.GetResultsInFullPath(globRoot)
+            .Select(x => Path.GetRelativePath(globRoot, x))
             .ToArray();
 
         var files = matchingFiles.Select(x =>
-            (Path.Join(this.ReadDir, x), Path.Join(this.WriteDir, x))
+            (Path.Join(globRoot, x), Path.Join(this.WriteDir, x))
         );
 
         foreach (var (read, write) in files)

sdks/node/src/api/core/core_mapper.ts

@@ -26,7 +26,7 @@ import type {
   SelectQ,
   TextQ,
 } from "../../domain/core/question.js";
-import { QuestionType } from "../../domain/core/question.js";
+
 import type {
   CheckboxQuestionRes,
   ConfirmQuestionRes,
@@ -44,6 +44,7 @@ import {
 } from "../../domain/core/answer.js";
 import { AnswerRes } from "./answer_res.js";
 import { AnswerReq, isBoolAnswerReq, isStringAnswerReq } from "./answer_req.js";
+import { QuestionType } from "../../domain/core/question.js";
 
 export class CyanMapper {
   static pluginReqToDomain(req: CyanPluginReq): CyanPlugin {
@@ -65,6 +66,7 @@ export class CyanMapper {
       }
     })();
     return {
+      root: req.root,
       glob: req.glob,
       exclude: req.exclude,
       type,
@@ -121,6 +123,7 @@ export class CyanMapper {
 
   static globToResp(data: CyanGlob): CyanGlobRes {
     return {
+      root: data.root,
       glob: data.glob,
       exclude: data.exclude,
       type: this.globTypeToResp(data.type),

sdks/node/src/api/core/cyan_req.ts

@@ -1,4 +1,5 @@
 interface CyanGlobReq {
+  readonly root?: string;
   readonly glob: string;
   readonly exclude: string[];
   readonly type: string;

sdks/node/src/api/core/cyan_res.ts

@@ -1,4 +1,5 @@
 interface CyanGlobRes {
+  readonly root?: string;
   glob: string;
   exclude: string[];
   type: string;

sdks/node/src/api/core/question_res.ts

@@ -16,31 +16,27 @@ interface DateQuestionRes {
 }
 
 interface CheckboxQuestionRes {
-  type: string;
   message: string;
   desc?: string | null;
   options: string[];
   type: "checkbox"; // Type discriminator value
 }
 
 interface PasswordQuestionRes {
-  type: string;
   message: string;
   desc?: string | null;
   confirmation?: boolean | null;
   type: "password"; // Type discriminator value
 }
 
 interface SelectQuestionRes {
-  type: string;
   message: string;
   options: string[];
   desc?: string | null;
   type: "select"; // Type discriminator value
 }
 
 interface TextQuestionRes {
-  type: string;
   message: string;
   default?: string | null;
   desc?: string | null;

sdks/node/src/domain/core/answer.ts

@@ -2,12 +2,10 @@ interface StringArrayAnswer {
   answer: string[];
 }
 
-// TypeScript equivalent of the C# record StringAnswer
 interface StringAnswer {
   answer: string;
 }
 
-// TypeScript equivalent of the C# record BoolAnswer
 interface BoolAnswer {
   answer: boolean;
 }

sdks/node/src/domain/core/cyan.ts

@@ -4,6 +4,7 @@ enum GlobType {
 }
 
 interface CyanGlob {
+  root?: string;
   glob: string;
   exclude: string[];
   type: GlobType;

sdks/node/src/domain/core/cyan_script.ts

@@ -14,7 +14,6 @@ interface ICyanTemplate {
   template(inquirer: IInquirer, determinism: IDeterminism): Promise<Cyan>;
 }
 
-// TypeScript equivalent of the C# interface ICyanExtension
 interface ICyanExtension {
   extension(
     inquirer: IInquirer,
@@ -23,18 +22,15 @@ interface ICyanExtension {
   ): Promise<Cyan>;
 }
 
-// TypeScript equivalent of the C# interface ICyanProcessor
 interface ICyanProcessor {
   process(
     input: CyanProcessorInput,
     fileHelper: CyanFileHelper,
   ): Promise<ProcessorOutput>;
 }
 
-// TypeScript equivalent of the C# interface ICyanPlugin
 interface ICyanPlugin {
   plugin(input: CyanPluginInput): Promise<PluginOutput>;
 }
 
-// export all
 export type { ICyanTemplate, ICyanExtension, ICyanProcessor, ICyanPlugin };