MagicBytesValidator 1.0.2

MagicBytesValidator

Recognize filetypes from Streams or IFormfiles using mime types or file extensions and validate them against the magic bytes according to filetypes. The existing FileTypes can be expanded in various ways.

How to install?

Install nuget package into your project

Install-Package MagicBytesValidator -Version 1.0.0

dotnet add package MagicBytesValidator --version 1.0.0

<PackageReference Include="MagicBytesValidator" Version="1.0.0" />

How to use it?

Create a new instance of the Validator

var validator = new Validator(); //or initialize it with DI

Check a file with the stream and the filetype

var isValid = await _validator.IsValidAsync(memoryStream, fileType);

Find a filetype by extension or mimetype

var pngFileType = validator.Mapping.FindByExtension("png");
var pdfFileType = validator.Mapping.FindByMimeType("application/pdf");

Expand default the filetype list

you can add or register your own filetypes. Use the validator or create an instance of the mapping.

var mapper = new Mapping();

Register a single Filetype

mapper.Register(
trpFileType = new FileType("traperto/trp", new[] { "trp" },
                                        new[] { new byte[] { 0x74, 0x72, 0x61, 0x70, 0x65, 0x72, 0x74, 0x6f } });
)

you can also register a list of filetypes

mapper.Register( listOfFileTypes );

You can also create variants of FileType and register them by passing the Assembly of the new FileTypes, e.g. mapping.Register(typeof(CustomFileType).Assembly);. This will register all FileTypes of the given Assembly that are also not abstract and have an empty constructor!

var assembly = typeof(MyAssembly).Assembly;
_mapping.Register(assembly);
)
public class CustomFileType : FileType
{
   public CustomFileType() : base("facade/trp", new[] { "trp" },
                                  new[] { new byte[] { 0x74, 0x72, 0x70 } })
    {
    }
}

List of Filetypes

What is the licence?

MIT License Feel free 😋

▓▓  ▓▓▓▓▓▓▓▓▓▓
▓▓          ▓▓
▓▓▓▓▓▓▓▓▓   ▓▓
▓▓          ▓▓            traperto GmbH
▓▓  ▓▓▓▓▓▓▓▓▓▓
▓▓
▓▓▓▓▓▓▓▓▓   ▓▓