add readme, System.IO.Abstraction

Author: danielklecha

README.md

@@ -1 +1,18 @@
-# SharpIppNextServer
+# SharpIppNextServer
+
+IPP printer (web app) based on `SharIppNext` library.
+
+## Installation
+
+1. Add manually using add printer wizard
+2. Add automatically using script
+    
+	- Windows: `add-printer -Name "SharpIpp on http://127.0.0.1:631" -DriverName "Microsoft IPP Class Driver" -PortName "http://127.0.0.1:631/"`
+3. Add to `NetPrinter` app from Google Play Store
+4. Add to IPP / CUPS printing for Chrome & Chromebooks extension from Chrome Web Store.
+
+## Integration testing
+
+1. Install package: `sudo zypper install cups-client cups-backends`
+2. Obtain correct IP: `ip route`
+3. Make test: `ipptool -t ipp://172.25.192.1 ipp-1.1.test`

SharpIppNextServer/Directory.Packages.props

@@ -21,6 +21,7 @@
     <PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="8.0.0" />
     <PackageVersion Include="System.Diagnostics.DiagnosticSource" Version="8.0.0" />
     <PackageVersion Include="System.Drawing.Common" Version="8.0.3" />
+    <PackageVersion Include="System.IO.Abstractions" Version="21.0.2" />
     <PackageVersion Include="System.Security.AccessControl" Version="6.0.0" />
     <PackageVersion Include="System.Security.Cryptography.ProtectedData" Version="8.0.0" />
     <PackageVersion Include="System.Security.Permissions" Version="8.0.0" />

SharpIppNextServer/Program.cs

@@ -4,12 +4,14 @@
 using SharpIpp;
 using SharpIppNextServer.Models;
 using SharpIppNextServer.Services;
+using System.IO.Abstractions;
 
 var builder = WebApplication.CreateBuilder(args);
 builder.Services
     .AddSingleton<IDateTimeProvider, DateTimeProvider>()
     .AddSingleton<IDateTimeOffsetProvider, DateTimeOffsetProvider>()
     .AddSingleton<ISharpIppServer, SharpIppServer>()
+    .AddSingleton<IFileSystem, FileSystem>()
     .Configure<KestrelServerOptions>(options => options.AllowSynchronousIO = true)
     .Configure<PrinterOptions>(builder.Configuration.GetSection("Printer"))
     .AddSingleton<PrinterService>()

SharpIppNextServer/Properties/launchSettings.json

@@ -12,26 +12,26 @@
     "http": {
       "commandName": "Project",
       "dotnetRunMessages": true,
-      "launchBrowser": true,
+      "launchBrowser": false,
       "launchUrl": "",
-      "applicationUrl": "http://localhost:631",
+      "applicationUrl": "http://0.0.0.0:631",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"
       }
     },
     "https": {
       "commandName": "Project",
       "dotnetRunMessages": true,
-      "launchBrowser": true,
+      "launchBrowser": false,
       "launchUrl": "",
-      "applicationUrl": "https://localhost:631;http://localhost:631",
+      "applicationUrl": "https://0.0.0.0:631;http://0.0.0.0:631",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"
       }
     },
     "IIS Express": {
       "commandName": "IISExpress",
-      "launchBrowser": true,
+      "launchBrowser": false,
       "launchUrl": "",
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"

SharpIppNextServer/Services/JobService.cs

@@ -2,12 +2,14 @@
 using Quartz;
 using SharpIpp.Models;
 using SharpIpp.Protocol.Models;
+using System.IO.Abstractions;
 
 namespace SharpIppNextServer.Services;
 
 public class JobService(
     PrinterService printerService,
-    IWebHostEnvironment env) : IJob
+    IWebHostEnvironment env,
+    IFileSystem fileSystem) : IJob
 {
     private readonly FileExtensionContentTypeProvider _contentTypeProvider = new();
 
@@ -69,7 +71,7 @@ private async Task SaveAsync(string prefix, SendUriRequest request)
         if (!result.IsSuccessStatusCode)
             return;
         using var stream = await result.Content.ReadAsStreamAsync();
-        await SaveAsync(stream, GetFileName(prefix, request.DocumentAttributes, Path.GetFileNameWithoutExtension(request.DocumentUri.LocalPath), Path.GetExtension(request.DocumentUri.LocalPath)));
+        await SaveAsync(stream, GetFileName(prefix, request.DocumentAttributes, fileSystem.Path.GetFileNameWithoutExtension(request.DocumentUri.LocalPath), fileSystem.Path.GetExtension(request.DocumentUri.LocalPath)));
     }
 
     private string GetFileName(string prefix, DocumentAttributes? documentAttributes, string? alternativeDocumentName = null, string? alternativeExtension = null)
@@ -82,9 +84,9 @@ private string GetFileName(string prefix, DocumentAttributes? documentAttributes
 
     private async Task SaveAsync(Stream stream, string fileName)
     {
-        var path = Path.Combine(env.ContentRootPath, "jobs", fileName);
-        Directory.CreateDirectory(Path.Combine(env.ContentRootPath, "jobs"));
-        using var fileStream = new FileStream(path, FileMode.OpenOrCreate);
+        var path = fileSystem.Path.Combine(env.ContentRootPath, "jobs", fileName);
+        fileSystem.Directory.CreateDirectory(fileSystem.Path.Combine(env.ContentRootPath, "jobs"));
+        using var fileStream = fileSystem.FileStream.New(path, FileMode.OpenOrCreate);
         await stream.CopyToAsync(fileStream);
     }
 }

SharpIppNextServer/SharpIppNextServer.csproj

@@ -16,6 +16,7 @@
   <ItemGroup>
     <PackageReference Include="Quartz.Extensions.Hosting" />
     <PackageReference Include="SharpIppNext" />
+    <PackageReference Include="System.IO.Abstractions" />
   </ItemGroup>
 
 </Project>