https://github.com/axuno/SmartFormat

A lightweight text templating library written in C# which can be a drop-in replacement for string.Format
https://github.com/axuno/SmartFormat

formatter localization netframework netstandard pluralization smartformat string-composition string-format

Last synced: about 1 month ago
JSON representation

A lightweight text templating library written in C# which can be a drop-in replacement for string.Format

• Host: GitHub
• URL: https://github.com/axuno/SmartFormat
• Owner: axuno
• License: other
• Created: 2010-10-10T18:43:26.000Z (over 14 years ago)
• Default Branch: main
• Last Pushed: 2024-10-25T18:21:19.000Z (6 months ago)
• Last Synced: 2024-10-29T15:33:04.221Z (6 months ago)
• Topics: formatter, localization, netframework, netstandard, pluralization, smartformat, string-composition, string-format
• Language: C#
• Homepage:
• Size: 3.4 MB
• Stars: 1,095
• Watchers: 34
• Forks: 105
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

        


[![GitHub release](https://img.shields.io/github/release/axuno/smartformat.net.svg?sort=semver)](https://github.com/axuno/SmartFormat.Net/releases/latest)

[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://github.com/axuno/SmartFormat.Net/blob/main/License.txt)

[![AppVeyor build status windows](https://img.shields.io/appveyor/job/build/axuno/smartformat/windows/version/v3.0?label=windows%20build)](https://ci.appveyor.com/project/axuno/smartformat/branch/version/v3.0)

[![AppVeyor build status linux](https://img.shields.io/appveyor/job/build/axuno/smartformat/linux/version/v3.0?label=linux%20build)](https://ci.appveyor.com/project/axuno/smartformat/branch/version/v3.0)

[![AppVeyor tests](https://img.shields.io/appveyor/tests/axuno/SmartFormat.svg)](https://ci.appveyor.com/project/axuno/SmartFormat/branch/main/tests)

[![codecov](https://codecov.io/gh/axuno/SmartFormat/branch/main/graph/badge.svg)](https://codecov.io/gh/axuno/SmartFormat)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=axuno_SmartFormat&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=axuno_SmartFormat)

[![Paypal-Donations](https://img.shields.io/badge/Donate-PayPal-important.svg?style=flat-square)](https://www.paypal.com/donate?hosted_button_id=KSC3LRAR26AHN)

**SmartFormat** is a is a **lightweight text templating** library written in C# which can be a drop-in replacement for `string.Format`. More than that **SmartFormat** can format data with named placeholders, lists, localization, pluralization and other smart extensions.

* High performance with low memory footprint

* Minimal, intuitive syntax

* Formatting takes place exclusively at runtime

* Exact control of whitespace text output

* `string.Format` compatibility mode and *SmartFormat* enhanced mode

* Most common data sources work out-of-the-box

* Many built-in formatting extensions

* Custom formatting and source extensions are easy to integrate

### Supported Target Frameworks

* .Net Framework 4.6.2 and later

* .Net Standard 2.0, .Net Standard 2.1

* .Net 6.0 or .Net 8.0

For the best optimizations and performance, use .NET 6.0 or .NET 8.0. You can expect a nice improvement in speed compared to .NET Framework 4.6.2.

 

### Get started

[![NuGet](https://img.shields.io/nuget/v/SmartFormat.svg)](https://www.nuget.org/packages/SmartFormat.Net/) Install the **full** NuGet package *-or-*

[![NuGet](https://img.shields.io/nuget/v/SmartFormat.svg)](https://www.nuget.org/packages/SmartFormat/) Install the **core** NuGet package

[![Docs](https://img.shields.io/badge/docs-up%20to%20date-brightgreen.svg)](https://github.com/axuno/SmartFormat/wiki)

Have a look at the [SmartFormat Wiki](https://github.com/axuno/SmartFormat/wiki)

### License

*SmartFormat* is licensed under [The MIT License (MIT)](LICENSE.md)

## Thanks!

We would like to thank [JetBrains](https://www.jetbrains.com/?from=SmartFormat) for supporting the project with free licenses of their fantastic tools.