Add a SocketPath type for linux systems

[theunkn0wn1]

Change Summary

The existing FilePath type does not accept sockets, as they fail the Path.is_file(self) check.
As such, I added a new SocketPath type and corresponding validator using Path.is_socket(self).

Related issue number

fix #10376

Checklist

• The pull request title is a good summary of the changes - it will be used in the changelog
• Unit tests for the changes exist
• Tests pass on CI
• Documentation reflects the changes where applicable
• My PR is ready to review, please add a comment including the phrase "please review" to assign reviewers

Selected Reviewer: @sydney-runkle

[codspeed-hq]

CodSpeed Performance Report

Merging #10378 will not alter performance

_{Comparing theunkn0wn1:user/theunkn0wn1/validate_socket (b874a82) with main (7daa2cd)}

Summary

✅ 49 untouched benchmarks

[theunkn0wn1]

Test will need to be skipped on windows; as it doesn't have sockets to begin with.
Not sure why the tests are failing on mac.

[Viicos]

I'm wondering if we should do something like:

Edit: Seems like on Windows, is_socket returns False, so maybe it's safe to not add these kind of conditions.

[sydney-runkle]

Looking good though, happy to support this once we get tests passing, etc :).

[theunkn0wn1]

ok for the issue with the Mac tests - pytest seems to be configured wrong, the temporary paths its generating with its fixture exceed the maximum length of a socket name on that platform.
Only way i can see to fix that would be to change the pytest config to use a more sensible base directory.
the trouble? i don't have a mac to test with and don't know what a sensible base path for that platform is.
Can I ask for some pointers here?

[Viicos]

ok for the issue with the Mac tests - pytest seems to be configured wrong, the temporary paths its generating with its fixture exceed the maximum length of a socket name on that platform.
Only way i can see to fix that would be to change the pytest config to use a more sensible base directory.
the trouble? i don't have a mac to test with and don't know what a sensible base path for that platform is.
Can I ask for some pointers here?

I'm ok only running the test on Linux. The goal isn't to test that creating sockets works, but to ensure that validate_socket works as expected when encountering a socket path.

[theunkn0wn1]

Added condition to skip new test if not linux.
squashed commits to one.
rebased against tip of upstream main. :)

[github-actions]

Coverage report

Click to see where and how coverage changed

File	Statements	Missing	Coverage	Coverage (new stmts)	Lines missing
pydantic
types.py					1277
Project Total

This report was generated by python-coverage-comment-action

[theunkn0wn1]

please review :)

[sydney-runkle]

Great, thanks!

[theunkn0wn1]

@sydney-runkle when can i expect this change to be released? 😇

[sydney-runkle]

@theunkn0wn1, with our 2.10 release in late October! Feel free to install from main in the meantime :)