feat: add validator for eth addresses

[msamsami]

• A new validator is added for the Ethereum address
• Crypto address validators combined into a new directory: src/validators/crypto_addresses

[msamsami]

Hi.
Please give me feedback on whether this is something you would like to be added to the library. If so, I can make the additional changes for versioning, changelog, etc.

Please note that I plan to extend this by adding more validators for TRX, ADA, and other crypto addresses.

Thanks!

[yozachar]

Hi, I'll review, but is it possible to make the external dependency, optional?

[msamsami]

Hi, I'll review, but is it possible to make the external dependency, optional?

Sure. Something like a new group of optional dependencies named crypto, crypto-address, or crypto-addresses that includes all the dependencies related to validators of crypto addresses. What do you think?
Please let me know your suggestions for the naming.

Finally, it can be used like pip install validators[crypto-addresses].

[yozachar]

That sound exactly like what I was thinking. pip install validators[crypto-eth-addresses]

[msamsami]

That sound exactly like what I was thinking. pip install validators[crypto-eth-addresses]

It's done. Now, how do you think we should update the pycqa.yaml workflow? I can explicitly include pip install .[crypto-eth-addresses] in "tooling" and "testing" jobs or create a new requirements.*.txt for it under package/ directory. Or is there a better way to do it? I'm trying to become close to your mindset here so that I can make more contributions with less confusion in the future. Thanks

[yozachar]

Change this:

validators/package/roll.sh

Lines 9 to 10 in a7bcfda

	# tooling
	pdm export --group tooling -f requirements -o package/requirements.tooling.txt

to:

    # tooling
    pdm export --group tooling,crypto-eth-addresses -f requirements -o package/requirements.tooling.txt

Do the same in roll.ps1. Run either of one the scripts (bash or powershell, depending upon your OS), commit and push those changes to this PR.

Let's see if it works.

[msamsami]

Change this:

validators/package/roll.sh

Lines 9 to 10 in a7bcfda

	# tooling
	pdm export --group tooling -f requirements -o package/requirements.tooling.txt

to:

    # tooling
    pdm export --group tooling,crypto-eth-addresses -f requirements -o package/requirements.tooling.txt

Do the same in roll.ps1. Run either of one the scripts (bash or powershell, depending upon your OS), commit and push those changes to this PR.

Let's see if it works.

It doesn't seem to be working. Isn't it because the optional dependencies are not installed here in the "testing" workflow?

validators/.github/workflows/pycqa.yaml

Lines 52 to 53 in a7bcfda

	- name: Install 'testing' dependencies
	run: pip install pytest

[yozachar]

Ah, you are right, then let's add a redundant dependency group with:

$ pdm add -dG testing pytest

This should change pyproject.toml to include:

[tool.pdm.dev-dependencies]
+ testing = ["pytest>=8.2.2"]

Do not remove pytest from tooling, it still is required there. Then in roll.(sh|ps1) generate a new file like so:

# tooling
pdm export --group tooling -f requirements -o package/requirements.tooling.txt
+# testing
+pdm export --group testing,crypto-eth-addresses -f requirements -o package/requirements.testing.txt

Finally in pycqa.yaml, you can make the following change:

-run: pip install pytest
+run: pip install -r package/requirements.testing.txt

Run the scripts, commit, push and try again.

[msamsami]

@yozachar All tests are passed except for the tooling workflow. Seems like we need crypto-eth-addresses in tooling dependencies as well. What do you think?

# tooling
-pdm export --group tooling -f requirements -o package/requirements.tooling.txt
+pdm export --group tooling,crypto-eth-addresses -f requirements -o package/requirements.tooling.txt
# testing
pdm export --group testing,crypto-eth-addresses -f requirements -o package/requirements.testing.txt

[yozachar]

Ah yes, I missed that.

[msamsami]

It's all good now.
Would you like to make a new release out of this PR? or after adding validators for more crypto addresses? If this counts as a release, I can update the SECURITY.md and src/validators/__init__.py files.

[yozachar]

This PR looks like a good candidate for 0.29.0. Please go ahead.

[msamsami]

This PR looks like a good candidate for 0.29.0. Please go ahead.

I updated the version and changelog. Let me know if this wraps it up or if more needs to be done.

[yozachar]

I'll push a few changes, just some arrangements.

[yozachar]

What do you think?

[msamsami]

What do you think?

Much better. Thanks!

[yozachar]

Thanks a lot for the PR!