Add `ParseOrNull` to major value types by Copilot · Pull Request #9 · Tyrrrz/PowerKit

Copilot · 2026-04-12T15:27:47Z

Adds ParseOrNull as a static extension method on major value types, mirroring the pattern from GitHubActionsTestLogger. Each method takes a string? and returns a nullable of the target type, yielding null on failure.

Types covered

Type	Simple overload defaults	Full overload parameters
`int`, `long`	`NumberStyles.Integer`, `CurrentCulture`	`NumberStyles`, `IFormatProvider?`
`double`	`NumberStyles.Float \| AllowThousands`, `CurrentCulture`	`NumberStyles`, `IFormatProvider?`
`decimal`	`NumberStyles.Number`, `CurrentCulture`	`NumberStyles`, `IFormatProvider?`
`bool`	`bool.TryParse`	—
`DateTime`, `DateTimeOffset`	`CurrentCulture`, `DateTimeStyles.None`	`IFormatProvider?`, `DateTimeStyles`
`TimeSpan`	`CurrentCulture`	`IFormatProvider?`
`Guid`	`Guid.TryParse`	—

Each type (except bool and Guid, which have no BCL formatting parameters) exposes a full overload accepting explicit formatting options. The simple ParseOrNull(string?) overload delegates to the full overload using CultureInfo.CurrentCulture as the default, consistent with the behavior of the base Parse methods.

Usage

// Simple overload (uses current culture, like Parse)
int.ParseOrNull("42")       // 42
int.ParseOrNull("abc")      // null
int.ParseOrNull(null)       // null

// Full overload with custom formatting
int.ParseOrNull("FF", NumberStyles.HexNumber, CultureInfo.InvariantCulture)  // 255

bool.ParseOrNull("true")    // true
Guid.ParseOrNull("not-a-guid") // null

Structure

Each type has its own dedicated file and host class (e.g. IntExtensions.cs / IntExtensions, LongExtensions.cs / LongExtensions, etc.), required because static ParseOrNull overloads with the same signature would collide in a single host class under the current C# preview extension member semantics. Tests are organized into matching per-type files (e.g. IntExtensionsTests.cs, LongExtensionsTests.cs, etc.).

Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/4dc30744-0f1d-4c83-af52-2231f02919ee Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz · 2026-04-12T15:29:07Z

Split each extension block into its own class/file.

Add overloads that allow passing custom formatting options, etc. Make the current overloads call those.

Test only the outermost overloads.

@copilot

Done in 8583988:

ParsingExtensions.cs is deleted — each type now has its own file (IntParsingExtensions.cs, LongParsingExtensions.cs, DoubleParsingExtensions.cs, DecimalParsingExtensions.cs, BoolParsingExtensions.cs, DateTimeParsingExtensions.cs, DateTimeOffsetParsingExtensions.cs, TimeSpanParsingExtensions.cs, GuidParsingExtensions.cs).

Formatting-options overloads added where applicable — numeric types get (string?, NumberStyles, IFormatProvider?), date/time types get (string?, IFormatProvider?, DateTimeStyles), TimeSpan gets (string?, IFormatProvider?). The simple overloads delegate to these. bool and Guid have no standard formatting parameters so they stay single-overload.

Tests only exercise the outermost ParseOrNull(string?) overloads (unchanged).

Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/36a5377d-1796-4811-a4d0-0b4724b3541e Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz · 2026-04-12T15:37:00Z

Instead of IntParsingExtensions, call it just IntExtensions, etc. Reorganize tests accordingly. @copilot

Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/3a5a128b-3368-43dd-90f7-237e6042cac7 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot · 2026-04-12T15:40:33Z

Instead of IntParsingExtensions, call it just IntExtensions, etc. Reorganize tests accordingly. @copilot

Done in 2d70ecf. All 9 host classes renamed (IntParsingExtensions → IntExtensions, etc.) with matching file renames. ParsingExtensionsTests.cs is split into 9 per-type test files (IntExtensionsTests.cs, LongExtensionsTests.cs, etc.), each with a single ParseOrNull_Test method.

Copilot

Pull request overview

Adds ParseOrNull static extension members for common value types in PowerKit.Extensions, providing a nullable-returning parse helper that defaults to InvariantCulture (where applicable) and returns null on unsuccessful parsing.

Changes:

Introduces ParseOrNull(string?) + (where applicable) formatting-parameter overloads for int, long, double, decimal, DateTime, DateTimeOffset, TimeSpan, plus simple bool and Guid variants.
Adds per-type unit tests validating basic success/failure/null cases for the simple overloads.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
PowerKit/Extensions/BoolExtensions.cs	Adds `bool.ParseOrNull(string?)` wrapper over `bool.TryParse`.
PowerKit/Extensions/GuidExtensions.cs	Adds `Guid.ParseOrNull(string?)` wrapper over `Guid.TryParse`.
PowerKit/Extensions/IntExtensions.cs	Adds `int.ParseOrNull` (default + `NumberStyles`/`IFormatProvider` overload).
PowerKit/Extensions/LongExtensions.cs	Adds `long.ParseOrNull` (default + `NumberStyles`/`IFormatProvider` overload).
PowerKit/Extensions/DoubleExtensions.cs	Adds `double.ParseOrNull` (default + `NumberStyles`/`IFormatProvider` overload).
PowerKit/Extensions/DecimalExtensions.cs	Adds `decimal.ParseOrNull` (default + `NumberStyles`/`IFormatProvider` overload).
PowerKit/Extensions/DateTimeExtensions.cs	Adds `DateTime.ParseOrNull` (default + `IFormatProvider`/`DateTimeStyles` overload).
PowerKit/Extensions/DateTimeOffsetExtensions.cs	Adds `DateTimeOffset.ParseOrNull` (default + `IFormatProvider`/`DateTimeStyles` overload).
PowerKit/Extensions/TimeSpanExtensions.cs	Adds `TimeSpan.ParseOrNull` (default + `IFormatProvider` overload).
PowerKit.Tests/BoolExtensionsTests.cs	Adds basic tests for `bool.ParseOrNull(string?)`.
PowerKit.Tests/GuidExtensionsTests.cs	Adds basic tests for `Guid.ParseOrNull(string?)`.
PowerKit.Tests/IntExtensionsTests.cs	Adds basic tests for `int.ParseOrNull(string?)`.
PowerKit.Tests/LongExtensionsTests.cs	Adds basic tests for `long.ParseOrNull(string?)`.
PowerKit.Tests/DoubleExtensionsTests.cs	Adds basic tests for `double.ParseOrNull(string?)`.
PowerKit.Tests/DecimalExtensionsTests.cs	Adds basic tests for `decimal.ParseOrNull(string?)`.
PowerKit.Tests/DateTimeExtensionsTests.cs	Adds basic tests for `DateTime.ParseOrNull(string?)`.
PowerKit.Tests/DateTimeOffsetExtensionsTests.cs	Adds basic tests for `DateTimeOffset.ParseOrNull(string?)`.
PowerKit.Tests/TimeSpanExtensionsTests.cs	Adds basic tests for `TimeSpan.ParseOrNull(string?)`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-12T15:45:34Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        int.ParseOrNull("42").Should().Be(42);
+        int.ParseOrNull("-7").Should().Be(-7);
+        int.ParseOrNull("abc").Should().BeNull();
+        int.ParseOrNull(null).Should().BeNull();


This test only covers the simple ParseOrNull(string?) overload. Since IntExtensions also introduces the overload that accepts NumberStyles and IFormatProvider, please add at least one test that exercises those parameters (e.g., parsing a hex value with NumberStyles.HexNumber and InvariantCulture) to ensure the overload is wired correctly.

Copilot · 2026-04-12T15:45:34Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        long.ParseOrNull("9876543210").Should().Be(9876543210L);
+        long.ParseOrNull("-1").Should().Be(-1L);
+        long.ParseOrNull("abc").Should().BeNull();
+        long.ParseOrNull(null).Should().BeNull();


This test only validates the simple ParseOrNull(string?) overload. LongExtensions also adds a NumberStyles/IFormatProvider overload, so it should have explicit test coverage (for example, a hex parse or a culture-specific thousands separator) to confirm the parameters are honored.

Copilot · 2026-04-12T15:45:34Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        double.ParseOrNull("3.14").Should().Be(3.14);
+        double.ParseOrNull("-1.5").Should().Be(-1.5);
+        double.ParseOrNull("abc").Should().BeNull();
+        double.ParseOrNull(null).Should().BeNull();


This test suite covers only the default ParseOrNull(string?) behavior. DoubleExtensions also introduces the overload that accepts NumberStyles and IFormatProvider, so please add a test that depends on those parameters (e.g., a culture with ',' decimal separator or parsing a thousands-formatted number) to verify the overload works as intended.

Copilot · 2026-04-12T15:45:34Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        decimal.ParseOrNull("3.14").Should().Be(3.14m);
+        decimal.ParseOrNull("-1.5").Should().Be(-1.5m);
+        decimal.ParseOrNull("abc").Should().BeNull();
+        decimal.ParseOrNull(null).Should().BeNull();


These assertions cover only the default ParseOrNull(string?) overload. Since DecimalExtensions adds a NumberStyles/IFormatProvider overload, please add a test that exercises that overload (for example, parsing a value with thousands separators or with a non-invariant culture) to ensure the formatting parameters are applied.

Copilot · 2026-04-12T15:45:35Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        DateTime.ParseOrNull("2024-06-15").Should().Be(new DateTime(2024, 6, 15));
+        DateTime.ParseOrNull("not a date").Should().BeNull();
+        DateTime.ParseOrNull(null).Should().BeNull();


This test covers only the simple ParseOrNull(string?) overload. DateTimeExtensions also adds an overload that accepts IFormatProvider and DateTimeStyles, so please add a test that requires non-default provider/styles (e.g., parsing a culture-specific date string) to validate that overload is correctly implemented.

Copilot · 2026-04-12T15:45:35Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        DateTimeOffset.ParseOrNull("2024-06-15T00:00:00+00:00").Should().Be(
+            new DateTimeOffset(2024, 6, 15, 0, 0, 0, TimeSpan.Zero)
+        );
+        DateTimeOffset.ParseOrNull("not a date").Should().BeNull();
+        DateTimeOffset.ParseOrNull(null).Should().BeNull();


This test only exercises the default ParseOrNull(string?) overload. DateTimeOffsetExtensions also adds an overload taking IFormatProvider and DateTimeStyles, so it needs explicit coverage (e.g., a culture-specific offset date/time format or a styles-dependent case) to ensure the overload parameters are actually used.

Copilot · 2026-04-12T15:45:35Z

+    [Fact]
+    public void ParseOrNull_Test()
+    {
+        // Act & assert
+        TimeSpan.ParseOrNull("1:30:00").Should().Be(new TimeSpan(1, 30, 0));
+        TimeSpan.ParseOrNull("not a timespan").Should().BeNull();
+        TimeSpan.ParseOrNull(null).Should().BeNull();


This test validates only the invariant-culture default ParseOrNull(string?) overload. TimeSpanExtensions also introduces the overload that accepts an IFormatProvider, so please add at least one test that uses a non-invariant culture-dependent format to confirm the formatProvider parameter is respected.

Tyrrrz · 2026-04-12T15:52:58Z

@copilot the overloads without extra parameters should default to the current culture, to be consistent with the bae Parse method

…e behavior Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/4a5577a4-6ae0-4ad3-9337-6bdf23cda70b Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot · 2026-04-12T15:54:50Z

@copilot the overloads without extra parameters should default to the current culture, to be consistent with the bae Parse method

Done in 159aeaa. All 7 simple ParseOrNull(string?) overloads (int, long, double, decimal, DateTime, DateTimeOffset, TimeSpan) now pass CultureInfo.CurrentCulture instead of CultureInfo.InvariantCulture, matching the behavior of the base Parse methods.

Add ParseOrNull to major value types

5d4bc16

Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/4dc30744-0f1d-4c83-af52-2231f02919ee Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot AI assigned Copilot and Tyrrrz Apr 12, 2026

Copilot created this pull request from a session on behalf of Tyrrrz April 12, 2026 15:27 View session

Tyrrrz added the enhancement New feature or request label Apr 12, 2026

Tyrrrz reviewed Apr 12, 2026

View reviewed changes

Copilot started work on behalf of Tyrrrz April 12, 2026 15:29 View session

Split ParseOrNull into per-type files with formatting overloads

8583988

Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/36a5377d-1796-4811-a4d0-0b4724b3541e Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot AI requested a review from Tyrrrz April 12, 2026 15:34

Copilot finished work on behalf of Tyrrrz April 12, 2026 15:34

Copilot started work on behalf of Tyrrrz April 12, 2026 15:37 View session

Rename *ParsingExtensions to *Extensions; split tests per type

2d70ecf

Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/3a5a128b-3368-43dd-90f7-237e6042cac7 Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Tyrrrz marked this pull request as ready for review April 12, 2026 15:41

Merge branch 'prime' into copilot/add-parse-or-null-to-major-value-types

1bf3baa

Copilot AI review requested due to automatic review settings April 12, 2026 15:41

Copilot finished work on behalf of Tyrrrz April 12, 2026 15:41

Copilot started reviewing on behalf of Tyrrrz April 12, 2026 15:41 View session

Tyrrrz approved these changes Apr 12, 2026

View reviewed changes

Copilot AI reviewed Apr 12, 2026

View reviewed changes

Copilot started work on behalf of Tyrrrz April 12, 2026 15:53 View session

Use CurrentCulture in simple ParseOrNull overloads to match base Pars…

159aeaa

…e behavior Agent-Logs-Url: https://github.com/Tyrrrz/PowerKit/sessions/4a5577a4-6ae0-4ad3-9337-6bdf23cda70b Co-authored-by: Tyrrrz <1935960+Tyrrrz@users.noreply.github.com>

Copilot finished work on behalf of Tyrrrz April 12, 2026 15:55

Copilot AI requested a review from Tyrrrz April 12, 2026 15:55

Tyrrrz merged commit 4a4a6f1 into prime Apr 12, 2026

Tyrrrz deleted the copilot/add-parse-or-null-to-major-value-types branch April 12, 2026 16:00

dependabot Bot mentioned this pull request May 1, 2026

Bump the nuget group with 8 updates Tyrrrz/GitHubActionsTestLogger#74

Merged

Conversation

Copilot AI commented Apr 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Types covered

Usage

Structure

Uh oh!

Tyrrrz Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Tyrrrz commented Apr 12, 2026

Uh oh!

Copilot AI commented Apr 12, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 12, 2026

Choose a reason for hiding this comment

Uh oh!

Tyrrrz commented Apr 12, 2026

Uh oh!

Copilot AI commented Apr 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Apr 12, 2026 •

edited

Loading