Add type hints

[bmwant]

Description

• To address issue Recent versions of VS Code are reporting Pylance errors #533
• Duplicate of Added python types for default arguments. #452

[github-actions]

Your PR was set to target main, PRs should be target develop
The base branch of this PR has been automatically changed to develop, please check that there are no merge conflicts.

[bmwant]

@sergeyklay can you trigger unittests workflow for the branch, I will update failing tests if any

[joaovl5]

Please add this!!

[du-song]

it will be awesome if we can have this.

[bmwant]

@joke2k do you have time to take a look at this?

[Ksauder]

This would be really nice!

[ashwanthbalakrishnan5]

@joke2k Any update on why this is not merged ?

[JackMorganNZ]

@joke2k Would be great if this could be merged, currently the package is highlighting a lot of errors in our repositories without this.

[Copilot]

Pull Request Overview

This PR adds type hints to various methods in the Environ class to improve code documentation and IDE support. The changes address issue #533 by providing explicit type annotations for method parameters and return values.

Key changes:

• Added type imports from the typing module including Union, TypeVar, List, Tuple, and Dict
• Added type hints to method signatures for str, bytes, bool, int, float, list, tuple, dict, url, and various URL parsing methods
• Specified return types and parameter types using Union types to handle both actual values and NoValue sentinel

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.}

[Copilot]

Using string quotes for forward references ('Path') is unnecessary here since the Path class is already defined in the codebase. Consider using Union[Path, NoValue] instead of Union['Path', NoValue].

Suggested change

	def path(self, var, default: Union['Path', NoValue] = NOTSET, **kwargs) -> 'Path':
	def path(self, var, default: Union[Path, NoValue] = NOTSET, **kwargs) -> Path:

[bmwant]

@joke2k do you want me to update code as per copilot comments?
Current approach is still valid by the PEP https://peps.python.org/pep-0484/,
but is encouraged to be more specific in 3.9+ by this one https://peps.python.org/pep-0585/