TinyString 0.1.0

TinyString

Turn any .NET object into a readable string. Zero config for simple cases, a clean fluent API when you want more.

dotnet add package TinyString

Zero config

Call .Stringify() on anything:

using TinyString;

var book = new Book { Title = "1984", Author = "George Orwell", Pages = 328 };
book.Stringify();
// → "Book. Title: 1984, Author: George Orwell, Pages: 328"

All public properties, declaration order, class name as header, floats at 2 decimal places. No setup required.

Fluent API

Pass a configuration action when you need more control. Everything lives at the call site — your classes stay clean:

zoo.Stringify(o => o
    .MultiLine()
    .Label("🦁 Zoo")
    .For(x => x.EntrancePrice).Prefix("$").Decimals(0));

🦁 Zoo
Name: Woodland Zoo
EntrancePrice: $15
Animals:
|_ Animal. Name: Mittens, Species: Cat, Weight: 4.50
|_ Animal. Name: Tony, Species: Tiger, Weight: 120.30

In multi-line mode, collections are automatically rendered with |_ per item. In single-line mode they're joined with ", ". No extra configuration needed.

Options

Global

Available naming formats: PascalCase, CamelCase, SnakeCase, KebabCase, HumanCase.

Per property

Chain .For(x => x.Prop) to configure a specific property, then keep chaining .For() to move to the next one:

animal.Stringify(o => o
    .NoLabel()
    .Separator(" ")
    .For(x => x.Name).NoKey()
    .For(x => x.Species).Prefix("(").Suffix(")").NoKey()
    .For(x => x.Weight).NoKey().Suffix("kg").Decimals(2)
    .For(x => x.Age).NoKey().Suffix("yrs")
    .For(x => x.IsRare).Ignore());
// → "Mittens (Cat) 4.50kg 5yrs"

Nested objects

Nested objects are stringified automatically using their own defaults:

var order = new Order { Product = new Product { Name = "Book", Price = 12.99 }, Qty = 2 };
order.Stringify();
// → "Order. Product: Product. Name: Book, Price: 12.99, Qty: 2"

Migrating from the attribute API

Previous versions configured stringification via [Stringify], [StringifyProperty], and [StringifyIgnore] attributes. These still work but are deprecated and will be removed in a future major version. Move the configuration to the .Stringify() call site instead.

MIT License