The pain of choice - Important libs for C# developers

The Pain of ChoiceWas in keinem Repertoire fehlen darf…

Fabian Deitelhoff

>>> dotnet-developer-conference.de #ddc13

Alle Beispiele sind online verfügbarhttps://github.com/Twainsoft/Twainsoft.Talks.DDC13.Libs


Ressourcen

Das berühmte Rad……nutzen. Nicht neu erfinden!


…Warum Bibliotheken kennen?

Neues kennenlernenInsbesondere Eindrücke und Ideen zu Problemstellungen.



WichtigOftmals reicht schon das Wissen aus, dass es etwas gibt!



WichtigZum Einsatz kommen kann es ruhig später.



Was mir wichtig ist!Das hier sind alles Beispiele. Bibliotheken gibt es viele.


…Disclaimer!

Zusammen ist doch schöner…Projekte bestehen in der Regel aus vielen Dateien.


…LibZ?

Während der Entwicklung?Normalerweise nicht das Problem. Die IDE macht das schon…


…LibZ?

Und beim Ausliefern?Das nervt schon mehr…


…LibZ?

Mergen ist eine LösungAssemblies beim Buildvorgang zu einer zusammenfassen.


…LibZ?

LibZKommandozeilentool zum Injizieren von Assemblies.


…LibZ?

LibZDirektes Injizieren oder über Container.


…LibZ?

LibZVerschiedene Kompressionsalgorithmen.


…LibZ?

LibZEinfaches Injizieren über eine Anweisung möglich.

set LIBZ="$(SolutionDir)packages\LibZ.Bootstrap.1.0.3.7\tools\libz.exe"

%LIBZ% inject-dll --assembly $(TargetFileName) --include *.dll--exclude LibZ.Bootstrap.dll --move


…LibZ?

LibZEinsatz von Container erfordert einige zusätzliche Anweisungen.

%LIBZ% add --libz DemoSuite.libz --include *.dll--exclude LibZ.Bootstrap.dll --codec deflate –move

%LIBZ% inject-libz -assembly $(TargetFileName) --libz DemoSuite.libz –move

%LIBZ% instrument --assembly $(TargetFileName) --libz-resources


…LibZ?

DemoMergen von Assemblies.


…LibZ?

Was es nicht ist!Keine Obfuskierung der Assemblies.


…LibZ?

Verarbeitet XML-KommentareStellt eine simple API bereit.


…NuDoc?

Verarbeitet XML-KommentareEinlesen als XML-Datei. Angabe der Assembly optional.


…NuDoc?

static void Main()

{

var docReader = DocReader.Read("ClariusLabs.NuDoc.xml");

docReader.Accept(new MarkdownVisitor("ausgabe-ohne-reflection.md"));

}

static void Main()

{

var docReader = DocReader.Read(Assembly.LoadFrom("ClariusLabs.NuDoc.dll"));

docReader.Accept(new MarkdownVisitor("ausgabe-mit-reflection.md"));

}


…NuDoc?

Vorteil der zweiten VarianteNuDoc reichert das in-memory Modell mit Informationen an.


…NuDoc?

Einfache VerarbeitungBasis bilden das Visitor- und das Composite-Pattern.


…NuDoc?

Einfache VerarbeitungJedes Element ist „besuchbar“.


…NuDoc?

Einfache VerarbeitungBei der Implementierung wird entschieden, was wichtig ist.


…NuDoc?

DemoXML-Kommentare zu Markdown.


…NuDoc?

Flüssigere BehauptungenErlaubt das Schreiben von Tests im TDD-Style.


…FluentAssertions?

Flüssigere BehauptungenTestergebnisse einfacher und natürlicher definieren.



Fluent InterfacesIntensiver Gebrauch für eine natürlichere Definition.



ErweiterungsmethodenFür alle denkbaren Typen für eine einfache Anwendung.



"Hallo Welt"

.Should()

.Be("Hallo welt");

Expected string to be "Hallo welt", but "Hallo

Welt" differs near "Wel" (index 6).

Expected string to be "Hallo welt2" with a length

of 11, but "Hallo Welt" has a length of 10.



KombinationenAuch Kombinationen von Bedingungen sind möglich.



"Hallo Welt"

.Should()

.Be("Hallo Welt")

.And.EndWith("T");

Expected string "Hallo Welt" to end with "T".



DemoString, Collection, Numeric, DateTime, Exception



Eine unter vielenEs gibt viele Fluent Assertion Bibliotheken. Anschauen lohnt sich!



Der „Umschalter“Funktion A für Kunde A, Funktion B für Kunde B…


…FeatureSwitcher?

Das ist gar nicht so einfach…Mögliche Lösungen sind Lizenzen, Branches, Feature Toggle.


…FeatureSwitcher?

Feature ToggleKonfigurierbare Schalter für Funktionen (Martin Fowler).


…FeatureSwitcher?

Feature ToggleKonfigurierbar ist das Schlüsselwort (zur Laufzeit).


…FeatureSwitcher?

Einfaches BeispielAbfrage eines Features anhand des Typs.

Features.Are.ConfiguredBy.Custom(Features.OfType<Colorize>.Enabled);

if (Feature<Colorize>.Is().Enabled)

{

Console.BackgroundColor = ConsoleColor.Blue;

Console.ForegroundColor = ConsoleColor.Yellow;

}


…FeatureSwitcher?

BesonderheitenKeine Strings, Typabfrage und ein einfacher Syntax.


…FeatureSwitcher?

DemoAbfragen eines Features, Konfigurationen.


…FeatureSwitcher?

AufpassenFeature Toggles sind toll. Allerdings nicht immer.


…FeatureSwitcher?

Lizensieren……will gelernt sein.


… Portable.Licensing?

LizenzenKönnen einen Anwender echt nerven…



LizenzenWenn überhaupt notwendig, so transparent wie möglich.



Bibliotheken nutzenKeine Gute Idee, das Rad neu zu erfinden!



Warum Portable.Licensing?Wenig Code notwendig. Viele Funktionen. Schnelle Integration.



Warum Portable.Licensing?Public-Key-Verschlüsselungsverfahren



Nur drei Schritte notwendigSchlüssel erzeugen, Lizenz erzeugen, Lizenz laden



1. Schlüssel erzeugen

Features.Are.ConfiguredBy.Custom(Features.OfType<Colorize>.Enabled);

var keyGenerator = Portable.Licensing.Security.Cryptography.KeyGenerator.Create();

var keyPair = keyGenerator.GenerateKeyPair();

PrivateKey = keyPair.ToEncryptedPrivateKeyString(password.Text.Trim());

PublicKey = keyPair.ToPublicKeyString();



2. Lizenz erzeugen

eatures.Are.ConfiguredBy.Custom(Features.OfType<Colorize>.Enabled);

var license = License.New()

.WithUniqueIdentifier(Guid.NewGuid())

.As(LicenseType.Trial)

.ExpiresAt(DateTime.Now.AddDays(30))

.CreateAndSignWithPrivateKey(PrivateKey, password);



3. Lizenz laden

eatures.Are.ConfiguredBy.Custom(Features.OfType<Colorize>.Enabled);

using (var streamReader = new StreamReader("License.lic"))

{

license = License.Load(streamReader);

}



DemoEine kleine und vollständige Anwendung.



Noch Fragen?


The Pain of Choice


Vielleicht noch interessant…

BouncyCastle

Vielen Dank für die Aufmerksamkeit!Viel Spaß noch auf der #DDC13!


The Pain of Choice


The Pain of ChoiceFabian Deitelhoff

Student, Master of Science Informatik

Schwerpunkt Biomedizinische Informatik

Autor, Speaker, Softwareentwickler

KontaktinformationenE-Mail: [email protected]

Twitter: @FDeitelhoff

Blog: http://www.fabiandeitelhoff.de

mailto:[email protected]

http://www.fabiandeitelhoff.de/

LibZhttp://libz.codeplex.com/

NuDochttps://github.com/clariuslabs/NuDoc

FluentAssertionshttps://github.com/dennisdoomen/FluentAssertions

FeatureSwitcherhttps://github.com/mexx/FeatureSwitcher

Portable.Licensinghttps://github.com/dnauck/Portable.Licensing


Ressourcen und Quellen

The pain of choice - Important libs for C# developers

Technology

Transcript of The pain of choice - Important libs for C# developers