0.15.0

.github/agents/dotnet-agent.md

@@ -0,0 +1,12 @@
+---
+name: dotnet expert
+description: Build amazing things in C#
+---
+
+# My Agent
+
+Designed to provide guidance and best practices for C# development and build http client tool likes httpie, this agent brings deep expertise in:
+
+- Core C# Development: Adheres to modern best practices for syntax, structure, and performance, while still honoring the preferences of the existing repository.
+- Code Integrity: Implements minimal code changes and writes efficient code utilizing async/await patterns with proper cancellation and exception handling.
+- Testing Best Practices: Supports behavior-driven unit testing practices, integration testing, and TDD workflows.

.github/copilot-instructions.md

@@ -0,0 +1,138 @@
+# dotnet-httpie
+
+A command-line HTTP client for .NET, providing a user-friendly alternative to curl for API testing and debugging. This tool can be installed as a global .NET tool or run as a Docker container.
+
+Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
+
+## Working Effectively
+
+### Build and Test Process
+
+- **NEVER CANCEL builds or tests** - Builds and tests typically complete quickly. Set timeout to 60+ seconds.
+- **Recommended Build Method**: `./build.sh` (uses dotnet-execute, builds and runs tests automatically)
+- **Alternative Build Methods**:
+  ```bash
+  dotnet build                    # Direct dotnet CLI
+  dotnet build dotnet-httpie.slnx # Specify solution file explicitly
+  ```
+- **Individual Test Commands**:
+  ```bash
+  dotnet test tests/HTTPie.UnitTest/HTTPie.UnitTest.csproj      # Unit tests
+  dotnet test tests/HTTPie.IntegrationTest/HTTPie.IntegrationTest.csproj # Integration tests
+  ```
+- **Package the tool**:
+  ```bash
+  dotnet pack src/HTTPie/HTTPie.csproj --configuration Release
+  ```
+
+### Running the Application
+
+- Run in development:
+  ```bash
+  dotnet run --project src/HTTPie/HTTPie.csproj --framework net10.0 -- --help
+  ```
+
+- Install as global tool:
+  ```bash
+  dotnet tool install --global --add-source src/HTTPie/bin/Release dotnet-httpie
+  dotnet-http --help
+  ```
+
+- Test basic functionality:
+  ```bash
+  # Test in offline mode (no network required)
+  dotnet-http https://httpbin.org/get --offline
+
+  # Execute .http files (test assets available)
+  dotnet-http exec tests/HTTPie.IntegrationTest/TestAssets/HttpStartedSample.http --offline
+  ```
+
+## Validation
+
+- **ALWAYS run complete build and test suite** before submitting changes
+- Build validation commands that MUST pass:
+  ```bash
+  dotnet build # build
+  dotnet test # run test cases  
+  dotnet pack src/HTTPie/HTTPie.csproj # pack artifacts
+  ```
+- **MANUAL VALIDATION SCENARIOS**: After code changes, test these workflows:
+  1. **CLI Help**: `dotnet-http --help` - verify all options display correctly
+  2. **HTTP Request**: `dotnet-http https://httpbin.org/get --offline` - verify request formatting
+  3. **HTTP File Execution**: `dotnet-http exec tests/HTTPie.IntegrationTest/TestAssets/HttpStartedSample.http --offline` - verify .http file parsing
+  4. **Package Installation**: Install as global tool and verify `dotnet-http` command works
+- Integration tests should pass when network connectivity is available
+
+## Key Project Structure
+
+### Repository Layout
+```
+/
+├── .github/workflows/     # CI/CD pipelines (dotnet.yml is main build)
+├── src/HTTPie/           # Main application project (multi-targets net8.0;net10.0)
+├── tests/                # Test projects
+│   ├── HTTPie.UnitTest/  # Unit tests (all should pass)
+│   └── HTTPie.IntegrationTest/  # Integration tests
+├── build/                # Build scripts and dotnet-execute configuration
+├── docs/                 # Release notes and documentation
+├── dotnet-httpie.slnx   # Solution file (requires .NET 10 SDK)
+├── build.sh             # Build script using dotnet-execute
+└── .husky/              # Git hooks (pre-commit runs dotnet build)
+```
+
+### Important Files
+- `src/HTTPie/HTTPie.csproj` - Main project, packaged as global tool (`dotnet-http` command)
+- `tests/HTTPie.IntegrationTest/TestAssets/` - Sample .http files for testing exec functionality
+- `build/build.cs` - Build script executed by dotnet-execute tool
+- `Directory.Build.props` - Common MSBuild properties (sets LangVersion to preview)
+
+### Technical Details
+- **Target Frameworks**: net8.0 and net10.0 (multi-targeting enabled)
+- **Package Output**: `src/HTTPie/bin/Release/dotnet-httpie.{version}.nupkg`
+- **AOT Compilation**: Enabled for Release builds on .NET 10 (PublishAot=true)
+
+## Common Development Tasks
+
+### Complete Development Workflow
+```bash
+# 1. Build and test (recommended - runs both build and tests)
+./build.sh
+
+# Alternative: Build and test separately
+# dotnet build
+# dotnet test
+
+# 2. Test functionality
+dotnet run --project src/HTTPie/HTTPie.csproj --framework net10.0 -- --help
+dotnet run --project src/HTTPie/HTTPie.csproj --framework net10.0 -- https://httpbin.org/get --offline
+
+# 3. Package and install
+dotnet pack src/HTTPie/HTTPie.csproj --configuration Release
+dotnet tool install --global --add-source src/HTTPie/bin/Release dotnet-httpie --version {version}
+```
+
+### Environment Setup Verification
+```bash
+# Verify .NET installation
+dotnet --list-sdks  # Should show 10.0.x
+dotnet --list-runtimes  # Should show Microsoft.NETCore.App 10.0.x
+
+# Verify tools
+dotnet-exec --info  # Should show dotnet-execute tool info
+which dotnet-http   # Should show path after global tool install
+```
+
+## Troubleshooting
+
+### Git Workflow
+- Pre-commit hook automatically runs `dotnet build` 
+- Always ensure builds pass before pushing
+- CI/CD runs on macOS, Linux, and Windows with .NET 10 SDK
+
+### Common Issues
+- **Build fails with "unrecognized Solution element"**: Install .NET 10 SDK, .NET 8 doesn't support .slnx format
+- **Tests fail with "Framework not found"**: Ensure .NET 10 runtime is installed and DOTNET_ROOT is set
+- **dotnet-execute build script fails**: The tool has compatibility issues with .NET 10 preview, use direct `dotnet build` instead
+- **Integration tests fail**: Ensure network connectivity is available for external service calls
+
+This project is a modern .NET tool that showcases advanced features like multi-targeting, AOT compilation, and global tool packaging. Always test the complete user workflow after making changes.

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,36 @@
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed to allow for easy validation, and
+# allow manual testing through the repository's "Actions" tab
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  # The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+
+    # Set the permissions to the lowest permissions possible needed for your steps.
+    # Copilot will be given its own token for its operations.
+    permissions:
+      # If you want to clone the repository as part of your setup steps, for example to install dependencies, you'll need the `contents: read` permission. If you don't clone the repository in your setup steps, Copilot will do this for you automatically after the steps complete.
+      contents: read
+
+    # You can define any steps you want, and they will run before the agent starts.
+    # If you do not check out your code, Copilot will do this for you.
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup .NET SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: |
+            8.0.x
+            9.0.x
+            10.0.x

.github/workflows/dotnet-outdated.yml

@@ -40,13 +40,12 @@ jobs:
         fi
     - name: Create Pull Request
       if: ${{ env.has_changes == 'true' }}
-      uses: peter-evans/create-pull-request@v3
+      uses: peter-evans/create-pull-request@v7
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
         commit-message: "Update NuGet Packages"
         title: 'Update NuGet Packages'
         body: >
           This PR updates the outdated NuGet packages.
-        labels: automated pr
+        labels: dependencies
         branch: update-nuget-dependencies
-        base: ${{ github.ref }}

Directory.Packages.props

@@ -7,15 +7,15 @@
     <PackageVersion Include="JsonPath.Net" Version="2.1.1" />
     <PackageVersion Include="JsonSchema.Net" Version="7.4.0" />
     <PackageVersion Include="MathNet.Numerics.Signed" Version="5.0.0" />
-    <PackageVersion Include="System.CommandLine" Version="2.0.0-rc.1.25451.107" />
-    <PackageVersion Condition="!$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net10.0'))" Include="System.Linq.AsyncEnumerable" Version="10.0.0-rc.1.25451.107" />
-    <PackageVersion Include="WeihanLi.Common" Version="1.0.82" />
+    <PackageVersion Include="System.CommandLine" Version="2.0.0" />
+    <PackageVersion Condition="!$([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'net10.0'))" Include="System.Linq.AsyncEnumerable" Version="10.0.0" />
+    <PackageVersion Include="WeihanLi.Common" Version="1.0.84" />
   </ItemGroup>
   <ItemGroup>
-    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
+    <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
     <PackageVersion Include="Moq" Version="4.20.72" />
-    <PackageVersion Include="xunit.v3" Version="3.0.1" />
-    <PackageVersion Include="Xunit.DependencyInjection" Version="10.7.0" />
+    <PackageVersion Include="xunit.v3" Version="3.2.0" />
+    <PackageVersion Include="Xunit.DependencyInjection" Version="11.1.0" />
     <PackageVersion Include="coverlet.collector" Version="6.0.4" />
   </ItemGroup>
-</Project>
+</Project>