public class Example
{
public static void MainTest()
{
Console.WriteLine("Custom entry point executed!");
}
public static void Execute()
{
Console.WriteLine("Alternative entry method");
}
}
# Use custom entry point
dotnet-exec example.cs --entry MainTest
# Start interactive mode
dotnet-exec
# In REPL:
> #r "nuget:Newtonsoft.Json"
> using Newtonsoft.Json;
> var obj = new { Name = "Test", Value = 42 };
> JsonConvert.SerializeObject(obj)
"{"Name":"Test","Value":42}"
Testing
Execute xUnit tests without project setup:
# Run test file
dotnet-exec test MyTests.cs
# Run multiple test files
dotnet-exec test Test1.cs Test2.cs Test3.cs
# Run tests with additional references
dotnet-exec test MyTests.cs \
-r 'nuget:Moq' \
-r 'nuget:FluentAssertions' \
-u 'Moq' \
-u 'FluentAssertions'
Example test file:
public class CalculatorTests
{
[Fact]
public void Add_TwoNumbers_ReturnsSum()
{
var result = 2 + 3;
Assert.Equal(5, result);
}
[Theory]
[InlineData(1, 2, 3)]
[InlineData(0, 0, 0)]
[InlineData(-1, 1, 0)]
public void Add_VariousInputs_ReturnsExpected(int a, int b, int expected)
{
var result = a + b;
Assert.Equal(expected, result);
}
}
Configuration Profiles
Save common configurations for reuse:
# Create a web development profile
dotnet-exec profile set webdev \
--web \
-r 'nuget:Swashbuckle.AspNetCore' \
-r 'nuget:AutoMapper' \
-u 'AutoMapper'
# List profiles
dotnet-exec profile ls
# Use profile
dotnet-exec MyWebScript.cs --profile webdev
# Get profile details
dotnet-exec profile get webdev
# Remove profile
dotnet-exec profile rm webdev
Command Aliases
Create shortcuts for frequently used commands:
# Create aliases
dotnet-exec alias set guid "Guid.NewGuid()"
dotnet-exec alias set now "DateTime.Now"
dotnet-exec alias set sha256 "Convert.ToHexString(System.Security.Cryptography.SHA256.HashData(Encoding.UTF8.GetBytes(args[0]))).Dump();"
dotnet-exec alias set base64 "Convert.ToBase64String(Encoding.UTF8.GetBytes(args[0])).Dump();"
# List aliases
dotnet-exec alias ls
# Use aliases
dotnet-exec guid
dotnet-exec now
dotnet-exec sha256 -- "text to hash"
dotnet-exec base64 -- "text to encode"
# Remove alias
dotnet-exec alias unset guid
Container Support
Execute with Docker/Podman without .NET SDK:
# Docker
docker run --rm weihanli/dotnet-exec:latest "1+1"
docker run --rm weihanli/dotnet-exec:latest "Guid.NewGuid()"
docker run --rm weihanli/dotnet-exec:latest "DateTime.Now"
# Podman
podman run --rm weihanli/dotnet-exec:latest "1+1"
# Mount local files
docker run --rm -v $(pwd):/workspace weihanli/dotnet-exec:latest MyScript.cs
# Get help
dotnet-exec --help
dotnet-exec profile --help
dotnet-exec alias --help
dotnet-exec test --help
# Tool/Runtime information
dotnet-exec info / dotnet-exec --info
Many thanks to all contributors and users of this project
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
