add support for any type of URL as long as it can be stringified

[MarcBresson]

Summary

for reference : #3142

This PR brings compatibility with pydantic HttpURL object (or any object).

I'm using pydantic HttpURL type in my project (for validation purposes) but had errors when I passed the pydantic http object directly to https.request function. If the type of the given request is not httpx.URL, then the object will be stringified and the string will be passed on urlparse.

Checklist

• I understand that this PR may be closed in case there was no previous discussion. (This doesn't apply to typos!)
• I've added a test for each change that was introduced, and I tried as much as possible to make a single atomic change.
• I've updated the documentation accordingly.

[Kludex]

This will allow any type, which makes the other 2 types in this union irrelevant.

Suggested change

	def __init__(self, url: URL | str | typing.Any = "", **kwargs: typing.Any) -> None:
	def __init__(self, url: URL | str = "", **kwargs: typing.Any) -> None:

Maybe what you want is something like this?

class HasDunderStr(Protocol):
    def __str__(self): ...

But... Not sure this is useful.

[MarcBresson]

I quite like keeping the first two types. It makes it explicit that there is a great compatibility for them.

I like your idea to use protocol. I'm gonna implement it right away.

[Kludex]

Note the "But... Not sure this is useful." 👀 👍

[MarcBresson]

It makes it explicit what can go in this function. An object that doesn't respect this protocol will effectively raise an error.