Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .chronus/changes/UpdateTargetVersions-2026-9-29-9-6-43.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
changeKind: fix
packages:
- "@typespec/http-client-java"
---

Update prerequisite documentation to recommend a supported Node.js LTS release and clarify that Maven is only required to build generated clients.
4 changes: 2 additions & 2 deletions packages/http-client-csharp/.tspd/docs/usage.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
### Prerequisite

- Install [Node.js](https://nodejs.org/download/) 20 or above. (Verify by running `node --version`)
- Install [**.NET 8.0 SDK**](https://dotnet.microsoft.com/download/dotnet/8.0) for your specific platform. (or a higher version)
- Install a supported [Node.js](https://nodejs.org/) LTS. (Verify by running `node --version`)
- Install [**.NET 10.0 SDK**](https://dotnet.microsoft.com/download/dotnet/10.0) for your specific platform. (or a higher version)

### Naming conventions

Expand Down
6 changes: 3 additions & 3 deletions packages/http-client-csharp/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,11 @@ Welcome! This guide will help you set up your development environment and contri

Before you begin, ensure you have the following installed:

- [Node.js](https://nodejs.org/) (version 20 or higher)
- [.NET 9.0 SDK](https://dotnet.microsoft.com/download/dotnet/9.0) (required - see global.json for exact version)
- Install a supported [Node.js](https://nodejs.org/) LTS. (Verify by running `node --version`)
- [.NET 10.0 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) (required - see [global.json](global.json) for the exact SDK version)
- [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [Git](https://git-scm.com/)
- [PowerShell](https://docs.microsoft.com/powershell/scripting/install/installing-powershell) (version 7.0 or higher, for advanced testing and code generation scenarios)
- [PowerShell 7](https://learn.microsoft.com/powershell/scripting/install/installing-powershell) (use a [supported release](https://learn.microsoft.com/powershell/scripting/install/powershell-support-lifecycle) for advanced testing and code generation scenarios)
- [Long Path Support](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#registry-setting-to-enable-long-paths) (Windows only required to avoid path length limitations during development)

## Getting Started
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ When making changes to the TypeSpec HTTP Client C# generator, it may be helpful

## Prerequisites

- **PowerShell 7.0 or later** (cross-platform: Windows, Linux, macOS)
- **A supported [PowerShell 7 release](https://learn.microsoft.com/powershell/scripting/install/powershell-support-lifecycle)** (cross-platform: Windows, Linux, macOS)
- Node.js and npm installed
- .NET SDK installed
- Local clone of the `typespec` repository (unbranded generator)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ protected virtual string GetSourceProjectFileContent()
AssemblyTitle = $"SDK Code Generation {CodeModelGenerator.Instance.Configuration.PackageName}",
Version = "1.0.0-beta.1",
PackageTags = CodeModelGenerator.Instance.Configuration.PackageName,
TargetFrameworks = "netstandard2.0;net8.0",
TargetFrameworks = "netstandard2.0;net10.0",
LangVersion = "latest",
GenerateDocumentationFile = true,
};
Expand Down Expand Up @@ -107,7 +107,7 @@ protected virtual string GetTestProjectFileContent()
{
var builder = new CSharpProjectWriter()
{
TargetFramework = "net8.0",
TargetFramework = "net10.0",
IsTestProject = true,
IsPackable = false,
};
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ public async Task Execute_WritesTestProjectContent()
var project = XDocument.Load(Path.Combine(_outputDir, "tests", "TestPackage.Tests.csproj"));
Assert.AreEqual("Microsoft.NET.Sdk", project.Root!.Attribute("Sdk")!.Value);
var properties = project.Root.Element("PropertyGroup")!;
Assert.AreEqual("net8.0", properties.Element("TargetFramework")!.Value);
Assert.AreEqual("net10.0", properties.Element("TargetFramework")!.Value);
Assert.AreEqual("true", properties.Element("IsTestProject")!.Value);
Assert.AreEqual("false", properties.Element("IsPackable")!.Value);

Expand All @@ -72,6 +72,16 @@ public async Task Execute_WritesTestProjectContent()
Assert.IsEmpty(project.Descendants("None"));
}

[Test]
public async Task Execute_WritesSourceProjectTargetFrameworks()
{
var scaffolding = new NewProjectScaffolding();
await scaffolding.Execute();

var project = XDocument.Load(Path.Combine(_outputDir, "src", "TestPackage.csproj"));
Assert.AreEqual("netstandard2.0;net10.0", project.Root!.Element("PropertyGroup")!.Element("TargetFrameworks")!.Value);
}

[Test]
public async Task Execute_PreservesExistingTestFiles()
{
Expand Down Expand Up @@ -107,7 +117,7 @@ public async Task Execute_UsesCustomTestProjectContent()
await scaffolding.Execute();

var project = XDocument.Load(Path.Combine(_outputDir, "tests", "TestPackage.Tests.csproj"));
Assert.AreEqual("net10.0", project.Root!.Element("PropertyGroup")!.Element("TargetFramework")!.Value);
Assert.AreEqual("net10.0-windows", project.Root!.Element("PropertyGroup")!.Element("TargetFramework")!.Value);
}

[Test]
Expand Down Expand Up @@ -177,7 +187,7 @@ private class TestScaffolding : NewProjectScaffolding

protected override string GetTestProjectFileContent()
{
return new CSharpProjectWriter { TargetFramework = "net10.0" }.Write();
return new CSharpProjectWriter { TargetFramework = "net10.0-windows" }.Write();
}

protected override Task WriteAdditionalFiles()
Expand Down
2 changes: 1 addition & 1 deletion packages/http-client-csharp/generator/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ See the architecture documentation [here](docs/architecture.md).

## Prerequisites

- [.NET Core SDK (8.0.x)](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- [.NET 10.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) (use the SDK version pinned in [global.json](../global.json))

## Build

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<!-- CS1591 is public API should have xml docs -->
<!-- In CadlRanch tests we generate stubs so these won't exist -->
<NoWarn>$(NoWarn);CS1591</NoWarn>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsGeneratedTestProject>true</IsGeneratedTestProject>
</PropertyGroup>
<Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory)..\.., Directory.Build.props))\Directory.Build.props" />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation SampleTypeSpec</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>SampleTypeSpec</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
<!-- CS1591 is public API should have xml docs -->
<!-- In CadlRanch tests we generate stubs so these won't exist -->
<NoWarn>$(NoWarn);CS1591</NoWarn>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsGeneratedTestProject>true</IsGeneratedTestProject>
</PropertyGroup>
<Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory)..\.., Directory.Build.props))\Directory.Build.props" />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Authentication.ApiKey</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Authentication.ApiKey</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Authentication.Http.Custom</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Authentication.Http.Custom</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Authentication.OAuth2</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Authentication.OAuth2</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Authentication.Union</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Authentication.Union</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation _Specs_.Azure.ClientGenerator.Core.ResponseAsBool</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>_Specs_.Azure.ClientGenerator.Core.ResponseAsBool</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation _Specs_.Azure.ClientGenerator.Core.ResponseReplacement</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>_Specs_.Azure.ClientGenerator.Core.ResponseReplacement</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Client.Structure.Service</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Client.Structure.Service</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Client.Structure.Service.Default</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Client.Structure.Service.Default</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Client.Structure.Service.Multi.Client</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Client.Structure.Service.Multi.Client</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Client.Structure.Service.Renamed.Operation</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Client.Structure.Service.Renamed.Operation</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Client.Structure.Service.TwoOperationGroup</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Client.Structure.Service.TwoOperationGroup</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Documentation</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Documentation</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Encode.Array</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Encode.Array</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Encode.Boolean</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Encode.Boolean</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net10.0</TargetFramework>
<IsTestProject>true</IsTestProject>
<IsPackable>false</IsPackable>
</PropertyGroup>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<AssemblyTitle>SDK Code Generation Encode.Bytes</AssemblyTitle>
<Version>1.0.0-beta.1</Version>
<PackageTags>Encode.Bytes</PackageTags>
<TargetFrameworks>netstandard2.0;net8.0</TargetFrameworks>
<TargetFrameworks>netstandard2.0;net10.0</TargetFrameworks>
<LangVersion>latest</LangVersion>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Expand Down
Loading
Loading