Configuration
-
There Isn't Any
-
EggEncoder is fully native and has no options to set. AddEggEncoder() takes no parameters:
-
builder.Services.AddEggEncoder();
+
Almost None
+
EggEncoder is fully native and has one optional setting: whether it logs. AddEggEncoder() takes an optional enableLogging parameter (default true):
+
builder.Services.AddEggEncoder(); // logs via ILogger<NativeEncoder> (default)
+builder.Services.AddEggEncoder(enableLogging: false); // fully silent
This registers IMediaEncoder → NativeEncoder (scoped). There's no engine to pick, no binary path to provide, and nothing that can fail to resolve at startup due to missing external tooling.
+
Every Probe/ConvertFile/CutFile call logs a start and a completion message at LogInformation, and logs (then rethrows) any failure at LogError — set enableLogging: false to suppress all of it, or leave it on and control verbosity the standard way via your app's logging configuration (e.g. "Logging:LogLevel:EggEncoder.NativeEncoder": "None" in appsettings.json).
Native Binary Resolution
The bundled libmp3lame.dll and libFLAC.dll are located automatically at runtime by NativeLibraryLoader, relative to AppContext.BaseDirectory — this is not configurable and requires no setup. See Native Binary Packaging for how the files get there.
diff --git a/docs/Dependency-Injection.html b/docs/Dependency-Injection.html
index 4bc12c0..5919c3e 100644
--- a/docs/Dependency-Injection.html
+++ b/docs/Dependency-Injection.html
@@ -43,7 +43,7 @@
Dependency Injection
What AddEggEncoder Registers
-
services.AddEggEncoder() registers exactly one service: IMediaEncoder → NativeEncoder (scoped). Inject it into a controller, a scoped service, or resolve it from an IServiceScope in a background worker.
+
services.AddEggEncoder() registers exactly one service: IMediaEncoder → NativeEncoder (scoped). Inject it into a controller, a scoped service, or resolve it from an IServiceScope in a background worker. Pass AddEggEncoder(enableLogging: false) to silence NativeEncoder's logging entirely — see Configuration.
Typical Registration
// Program.cs
diff --git a/docs/index.html b/docs/index.html
index 040325d..54be6e2 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -122,7 +122,7 @@ Key Features
🔌
One-Line DI
-
services.AddEggEncoder() registers IMediaEncoder — no options, no config required.
+
services.AddEggEncoder() registers IMediaEncoder — no config required, one optional flag to silence logging.
diff --git a/llms-full.txt b/llms-full.txt
index b0c8cd7..17169f2 100644
--- a/llms-full.txt
+++ b/llms-full.txt
@@ -58,7 +58,8 @@ Only fields this library can genuinely compute are populated -- nothing is fille
```csharp
using EggEncoder;
-builder.Services.AddEggEncoder(); // no options — registers IMediaEncoder -> NativeEncoder (scoped)
+builder.Services.AddEggEncoder(); // registers IMediaEncoder -> NativeEncoder (scoped)
+// optional: AddEggEncoder(enableLogging: false) to silence Start/Completed/Failed logging entirely
```
### Consuming IMediaEncoder
diff --git a/src/EggEncoder.UnitTests/NativeEncoderTest.cs b/src/EggEncoder.UnitTests/NativeEncoderTest.cs
index c3aa126..29a09c6 100644
--- a/src/EggEncoder.UnitTests/NativeEncoderTest.cs
+++ b/src/EggEncoder.UnitTests/NativeEncoderTest.cs
@@ -192,6 +192,75 @@ public async Task CutFile_ToNestedMissingDirectory_Should_CreateDirectory_And_Cu
}
}
+ [Fact]
+ public async Task Probe_Should_Log_Start_And_Completion()
+ {
+ await _nativeEncoder.Probe(_wavFixturePath);
+
+ _logger.Invocations.Should().HaveCountGreaterThanOrEqualTo(2, "both a start and a completion message should be logged");
+ }
+
+ [Fact]
+ public async Task ConvertFile_Should_Log_Start_And_Completion()
+ {
+ var tempDirectory = CreateTempDirectory();
+
+ try
+ {
+ var destPath = Path.Combine(tempDirectory, "dest.flac");
+
+ await _nativeEncoder.ConvertFile(_wavFixturePath, destPath);
+
+ _logger.Invocations.Should().HaveCountGreaterThanOrEqualTo(2, "both a start and a completion message should be logged");
+ }
+ finally
+ {
+ Directory.Delete(tempDirectory, recursive: true);
+ }
+ }
+
+ [Fact]
+ public async Task CutFile_Should_Log_Start_And_Completion()
+ {
+ var tempDirectory = CreateTempDirectory();
+
+ try
+ {
+ var destPath = Path.Combine(tempDirectory, "cut.wav");
+
+ await _nativeEncoder.CutFile(_wavFixturePath, destPath, 0, 1);
+
+ _logger.Invocations.Should().HaveCountGreaterThanOrEqualTo(2, "both a start and a completion message should be logged");
+ }
+ finally
+ {
+ Directory.Delete(tempDirectory, recursive: true);
+ }
+ }
+
+ [Fact]
+ public async Task Probe_WithLoggingDisabled_Should_Not_Log()
+ {
+ var logger = new Mock