Skip to content

Commit 0124786

Browse files
committed
Increase version, add readme
1 parent 2febc32 commit 0124786

File tree

2 files changed

+41
-2
lines changed

2 files changed

+41
-2
lines changed

docs/README.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Nager.EmailAuthentication
2+
3+
Nager.EmailAuthentication is a .NET library designed to parse and validate DMARC and DKIM easily.
4+
With built-in support for error handling and validation, this library simplifies working with email authentication configurations.
5+
6+
## Features
7+
8+
- Parse DMARC records with comprehensive validation.
9+
- Parse DKIM Public Key records with comprehensive validation.
10+
- Parse DKIM Signatures with comprehensive validation.
11+
- Parse SPF records
12+
- Identify and report errors in DMARC configurations.
13+
- Identify and report errors in DKIM configurations.
14+
15+
## Examples
16+
17+
**Parsing a DMARC Record**
18+
```cs
19+
var dmarcRecordRaw = "v=DMARC1; p=reject;";
20+
if (!DmarcRecordParser.TryParse(dmarcRecordRaw, out var dmarcRecord))
21+
{
22+
}
23+
```
24+
25+
**Handling Validation Errors**
26+
```cs
27+
var dmarcRecord = "v=DMARC1; p=invalid;";
28+
if (!DmarcRecordDataFragmentParser.TryParse(dmarcRecord, out var dmarcDataFragment, out var parsingResults))
29+
{
30+
}
31+
```
32+
33+
## License
34+
35+
This project is licensed under the MIT License. See the LICENSE file for details.

src/Nager.EmailAuthentication/Nager.EmailAuthentication.csproj

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,16 +13,20 @@
1313

1414
<!--<PackageIcon>logo.png</PackageIcon>-->
1515
<PackageLicenseExpression>MIT</PackageLicenseExpression>
16-
<!--<PackageReadmeFile>README.md</PackageReadmeFile>-->
16+
<PackageReadmeFile>README.md</PackageReadmeFile>
1717
<!--<PackageReleaseNotes></PackageReleaseNotes>-->
1818
<PackageProjectUrl>https://github.com/nager/Nager.EmailAuthentication</PackageProjectUrl>
1919
<PackageTags>EmailAuthentication Dmarc Dkim</PackageTags>
2020

2121
<TargetFrameworks>net8.0;net9.0</TargetFrameworks>
2222

23-
<Version>3.0.0-alpha</Version>
23+
<Version>3.0.0</Version>
2424
</PropertyGroup>
2525

26+
<ItemGroup>
27+
<None Include="..\..\docs\README.md" Pack="true" PackagePath="\" />
28+
</ItemGroup>
29+
2630
<ItemGroup>
2731
<PackageReference Include="Nager.KeyValueParser" Version="1.1.0" />
2832
</ItemGroup>

0 commit comments

Comments
 (0)