Altinn.Urn 2.1.0

There is a newer version of this package available.
See the version list below for details.

dotnet add package Altinn.Urn --version 2.1.0

NuGet\Install-Package Altinn.Urn -Version 2.1.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Altinn.Urn" Version="2.1.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Altinn.Urn --version 2.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Altinn.Urn, 2.1.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install Altinn.Urn as a Cake Addin
#addin nuget:?package=Altinn.Urn&version=2.1.0

// Install Altinn.Urn as a Cake Tool
#tool nuget:?package=Altinn.Urn&version=2.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Altinn.Urn

Altinn.Urn is a .NET library designed to simplify working with URNs (Uniform Resource Names) in .NET applications. It provides functionalities to create custom URN types, serialize and deserialize them to/from JSON, and streamline the process of creating URNs within your applications.

Features

Altinn.Urn offers the following key features:

Custom URN Types: Easily define and create custom URN types in your .NET applications. This allows you to establish contracts that require specific types of URNs, providing clarity and consistency in your codebase.
JSON Serialization and Deserialization: Seamlessly serialize and deserialize custom URN types to and from JSON. This simplifies the integration of URNs into your application's data interchange format, making it easier to work with URNs in JSON-based APIs and data storage.
Simplified URN Creation: Once you've defined your custom URN types, Altinn.Urn simplifies the process of creating URNs within your application. This reduces boilerplate code and enhances code readability, and reduces the chance of typos.

Getting Started

To get started with Altinn.Urn, follow these steps:

Installation: Install the Altinn.Urn package from NuGet into your .NET project.
```
dotnet add package Altinn.Urn
```
Define Custom URN Types: Define your custom URN types by creating a partial record and adding the Urn attributes provided by Altinn.Urn. Specify the desired URN prefix and implement any additional logic specific to your URN type.
```
[Urn]
public partial record MyCustomUrn
{
    [UrnType("book")]
    public partial bool IsBook(out BookIdentifier bookId);

    [UrnType("cd")]
    [UrnType("record")]
    public partial bool IsSoundMedium(out int id);
}
```
Serialize and Deserialize: Altinn.Urn automatically handles the serialization and deserialization of custom URN types to and from JSON. Simply use your custom URN types as you would any other .NET types.
```
var urn = MyCustomUrn.SoundMedium.Create(123456);
string json = JsonSerializer.Serialize(urn);
MyCustomUrn deserializedUrn = JsonSerializer.Deserialize<MyCustomUrn>(json);
```
Create URNs: Create instances of your custom URN types using the provided constructors, passing the necessary parameters.
```
var urn = MyCustomUrn.SoundMedium.Create(123456);
```

Example

Here's a quick example demonstrating the usage of Altinn.Urn:

// Define custom URN type
[Urn]
public partial record MyCustomUrn
{
    [UrnType("book")]
    public partial bool IsBook(out BookIdentifier bookId);

    [UrnType("cd")]
    [UrnType("record")]
    public partial bool IsSoundMedium(out int id);
}

// Create and serialize URN
var urn = MyCustomUrn.SoundMedium.Create(123456);
string json = JsonSerializer.Serialize(urn);

// Deserialize URN
MyCustomUrn deserializedUrn = JsonSerializer.Deserialize<MyCustomUrn>(json);

Contributing

Contributions to Altinn.Urn are welcome! Feel free to open issues for bug reports, feature requests, or submit pull requests with improvements.

License

Altinn.Urn is licensed under the MIT License.

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. 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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Altinn.Urn:

Package	Downloads
Altinn.Urn.Swashbuckle Package Description	4.4K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
2.5.1	1,548	10/18/2024
2.5.0	1,756	8/22/2024
2.4.0	134	8/21/2024
2.3.2	655	6/12/2024
2.3.1	423	5/14/2024
2.3.0	304	4/26/2024
2.2.2	117	4/25/2024
2.2.1	163	4/23/2024
2.2.0	103	4/23/2024
2.1.1	106	4/22/2024
2.1.0	98	4/22/2024
2.0.0	111	4/10/2024
1.6.5	110	4/5/2024
1.6.4	80	4/5/2024
1.6.3	98	4/5/2024