Improve root namespace definition for templates

[YuliiaKovalova]

Is your feature request related to a problem? Please describe.

Feature request

Describe the solution you'd like.

• Classes are generated with the same namespace as their containing project name but with additional segments added for any subfolders from the directory containing the project file to the class file)
• Classes are generated with the same namespace as their containing project name unless root namespace is specified in the project file addition additional segments to the namespace for each folder
  Based on Consider adding a class item template #1713

Additional context

No response

[egvijayanand]

Yes, the namespace needs to get synced with the containing folder name included (relative to the project file).

For example, BaseViewModel is a type created under the ViewModels folder, but when the parameter is defined as mentioned in this Docs page, the generated namespace is either the project name or the value defined for RootNamespace property in the project file.

namespace MyApp;

public class BaseViewModel
{
}

[smitpatel]

We dotnet new class to generate new class in C# dev kit and we have received multiple feedback from customers that they would like the namespace to be aligned with folder. We should try to make best effort for the easy common case to get sub-namespaces. From CLI perspective, I can also see that people could be invoking command and putting output in directory which is not subfolder inside folder containing project file (through output or project switch), we can just use rootnamespace in such cases when we cannot compute relative path.

[henriqueTr25]

Any updates on that ?

[sayedihashimi]

I have a sample of a Class template which gets the projects rootnamespace and uses that as the namespace declaration. Sample is at https://github.com/sayedihashimi/template-sample/blob/main/src/contoso-templatepack/content/item-templates/classfile/.template.config/template.json, I've pasted the template.json below. This doesn't solve adding the relative folder path though.

I believe this only works with .net 8+ but could be wrong on that. @baronfel will know which version the support is in.

{
  "$schema": "http://json.schemastore.org/template",
  "$comment": "Code for this template is available at https://github.com/sayedihashimi/template-sample",
  "author": "Contoso",
  "classifications": ["template"],
  "name": "contoso-class",
  "description": "Contoso item template for a class file with a Contoso approved license.",
  "identity": "Contoso.Templates.Item.ClassWithLicense",
  "shortName": "cclass",
  "tags": {
    "language": "C#",
    "type": "item"
  },
  "sourceName": "SampleClassFile",
  "defaultName": "MyClass",
  "symbols": {
    "DefaultNamespace": {
      "type": "bind",
      "binding": "msbuild:RootNamespace",
      "replaces": "Contoso.Starter",
      "defaultValue": "Contoso"
    }
  },
  "primaryOutputs": [
    {
      "path": "SampleClassFile.cs"
    }
  ],
  "postActions": [
    {
      "id": "openInEditor",
      "condition": "(HostIdentifier != \"dotnetcli\" && HostIdentifier != \"dotnetcli-preview\")",
      "description": "Opens generated files in the editor",
      "manualInstructions": [],
      "actionId": "84C0DA21-51C8-4541-9940-6CA19AF04EE6",
      "args": {
        "files": "0"
      },
      "continueOnError": true
    }
  ]
}

In the sample above you can see the DefaultNamespace symbol which replaces the string Contoso.Starter in the template files that are generated.

[egvijayanand]

@sayedihashimi While using the parameter $rootnamespace$ in the VS native templates, it automatically takes the containing folder as part of the namespace emitted in the output. (Link 1).

https://github.com/egvijayanand/dotnet-maui-templates/blob/e111e3c33dc2ee22206a52d1fce716049c949cc4/src/ItemTemplates/PartialClass/MyClass.cs#L7

https://github.com/egvijayanand/dotnet-maui-templates/blob/e111e3c33dc2ee22206a52d1fce716049c949cc4/src/MauiTemplatesCLI/MyClass/.template.config/template.json#L24

For example, assume Contoso as the root namespace defined and the item is created inside the Models folder, then the value emitted would be Contoso.Models. Whereas with this modern CLI templating, it stops with Contoso, and the containing folder is ignored. Additional work even after automation. Painful for multi-file templates like XAML and its code-behind, have to update it in different locations. The folder path relative to the project file should also be included in the namespace emitted. (Link 2).

Kindly look into it.

[sayedihashimi]

Thanks, yes we will need to figure out a way to get the relative folder path into the generated namespace. I will discuss with the team to see what options we have.

[egvijayanand]

How to get the current path of the "dotnet new" while processing the template, like the bind symbol (host/env)?

Need the current directory while processing an item template.

Any possibility of using Environment.CurrentDirectory or something of that sort?

Any input would be highly appreciated.