https://github.com/igorskyflyer/npm-zing

🐌 Zing is a C# style String formatter for JavaScript that empowers Strings with positional arguments - composite formatting. 🚀
https://github.com/igorskyflyer/npm-zing

back-end biome c-style cs csharp formatter igorskyflyer javascript js npm print printf string system utility vitest zing

Last synced: 4 months ago
JSON representation

🐌 Zing is a C# style String formatter for JavaScript that empowers Strings with positional arguments - composite formatting. 🚀

• Host: GitHub
• URL: https://github.com/igorskyflyer/npm-zing
• Owner: igorskyflyer
• License: mit
• Created: 2022-08-18T02:40:30.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-07-10T22:56:05.000Z (about 2 years ago)
• Last Synced: 2025-03-07T20:48:47.202Z (over 1 year ago)
• Topics: back-end, biome, c-style, cs, csharp, formatter, igorskyflyer, javascript, js, npm, print, printf, string, system, utility, vitest, zing
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/@igor.dvlpr/zing
• Size: 82 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          


  

  
Zing








  🐌 Zing is a C# style String formatter for JavaScript that empowers Strings with positional arguments - composite formatting. 🚀









## 📃 Table of Contents

- [Features](#-features)

- [Usage](#-usage)

- [API](#-api)

- [Changelog](#-changelog)

- [Support](#-support)

- [License](#-license)

- [Related](#-related)

- [Author](#-author)







## 🤖 Features

 - ⚡ Quick formatting - Drop in `{0}`, `{1}` placeholders and swap them instantly

 - 🛠 C#-style syntax - Familiar composite formatting for .NET devs in JS/TS

 - 🎯 Positional arguments - Control exactly where each value lands

 - 🛡 Safe fallback - Leaves unknown placeholders untouched

 - 🧩 Lightweight utility - No dependencies, minimal footprint

 - 🔄 Multi-replace - Handles all matching placeholders in one pass

 - 📜 TypeScript-ready - Strong typing for cleaner code

 - 🌍 Cross-platform - Works in browser and Node environments




> ℹ️ **NOTE**

>

> More information about [composite formatting](https://docs.microsoft.com/en-us/dotnet/standard/base-types/composite-formatting).

>







## 🕵🏼 Usage

Install it by executing any of the following, depending on your preferred package manager:

```bash

pnpm add @igorskyflyer/zing

```

```bash

yarn add @igorskyflyer/zing

```

```bash

npm i @igorskyflyer/zing

```







## 🤹🏼 API

```ts

zing(value: string, ...args: any[]): string

```

Formats the provided string in a C# style format, i.e. adds the ability to use positional arguments, like seen with `String.Format` in C#.




`value: string` => The string to process that support positional parameters, i.e. `zing('Hello {0} {1}', 'Igor', 'Dimitrijević')` would output `Hello Igor Dimitrijević`.

The returned value is always a `string`.







## 📝 Changelog

📑 The changelog is available here, [CHANGELOG.md](https://github.com/igorskyflyer/npm-zing/blob/main/CHANGELOG.md).







## 🪪 License

Licensed under the MIT license which is available here, [MIT license](https://github.com/igorskyflyer/npm-zing/blob/main/LICENSE).







## 💖 Support



  I work hard for every project, including this one and your support means a lot to me!

  


  Consider buying me a coffee. ☕

  


  


  

  


  


  Thank you for supporting my efforts! 🙏😊









## 🧬 Related

[@igorskyflyer/recursive-readdir](https://www.npmjs.com/package/@igorskyflyer/recursive-readdir)

> _📖 Provides recursive readdir() and readdirSync() functions. 📁_




[@igorskyflyer/regkeys](https://www.npmjs.com/package/@igorskyflyer/regkeys)

> _📚 An npm package for fetching Windows registry keys. 🗝_




[@igorskyflyer/jmap](https://www.npmjs.com/package/@igorskyflyer/jmap)

> _🕶️ Reads a JSON file into a Map. 🌻_




[@igorskyflyer/unc-path](https://www.npmjs.com/package/@igorskyflyer/unc-path)

> _🥽 Provides ways of parsing UNC paths and checking whether they are valid. 🎱_




[@igorskyflyer/scrollend-polyfill](https://www.npmjs.com/package/@igorskyflyer/scrollend-polyfill)

> _🛴 A performant and light (< 1KB) JavaScript polyfill for the scrollend Event. ⛸️_










## 👨🏻‍💻 Author

Created by **Igor Dimitrijević** ([*@igorskyflyer*](https://github.com/igorskyflyer/)).