Promptuarium 5.0.0
dotnet add package Promptuarium --version 5.0.0
NuGet\Install-Package Promptuarium -Version 5.0.0
<PackageReference Include="Promptuarium" Version="5.0.0" />
paket add Promptuarium --version 5.0.0
#r "nuget: Promptuarium, 5.0.0"
// Install Promptuarium as a Cake Addin
#addin nuget:?package=Promptuarium&version=5.0.0
// Install Promptuarium as a Cake Tool
#tool nuget:?package=Promptuarium&version=5.0.0
Promptuarium
Project summary
Promptuarium is a versatile, tree-based data structure to store or exchange data and metadata efficiently (in binary format). Written in pure C#, but can be used in F#, as well.
Last reviewed: 13. Aug. 2023.
Promptuarium details
Promptuarium is a tree-based solution to store data and metadata in a file stream or exchange data and metadata through network streams efficiently.
However, Promptuarium doesn't use any compression algorithms, it saves as many bytes as possible (uses binary container format). Theoretically, there is no size limit in the binary container, but the .NET limits the data/metadata sizes to 8 exabytes.
The class has list- and LINQ-friendly operations to make it easy to use Promptuarium in any .NET project.
There are many-many conversion operations that simplifies storing and exchanging data (supported by the converter class):
- bool,
- byte, byte array,
- char,
- short, integer, long, (enumeration),
- float, double,
- decimal,
- DateTime, DateTimeOffset, TimeSpan,
- GUID,
- string (ASCII, UTF-8, UTF-16LE and UTF-32LE),
- VarInt and VarUInt saves as many bytes as possible.
Storing other types are also easy, just serialize them into a stream or byte array. The events help you to load the node content dynamically, i.e. keep big data in file streams.
The Statistics property gives information about i.e.
- the number of nodes,
- the depth of the tree,
- maximum and minimum of the length of the data/metadata,
- the minimum and maximum number of children,
- the number of nodes with and without data/metadata/children.
Documentation
See also the Wiki page or the API Reference.
Unit tests
Unit tests help to keep the project code robust.
NuGet packages
License
This code is is distributed under the terms of the MIT license.
Internals
Generate documentation:
cd src
roslynator.exe generate-doc .\Promptuarium.csproj -o ..\docs --host github --heading "Promptuarium API Reference"
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
| .NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.1 is compatible. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Children is IReadOnlyList.