Add comprehensive IPv6 examples and documentation for IP address support

[Copilot]

This PR enhances the existing IP address functionality by adding comprehensive IPv6 examples and documentation to demonstrate the full range of supported address formats.

What's Changed

Enhanced Documentation

• Added dedicated "IP Address Support" section explaining both IPv4 and IPv6 capabilities
• Organized usage examples by protocol with clear IPv4 and IPv6 sections
• Added 6 comprehensive IPv6 examples covering all major address formats:
  • Compressed notation (::1, 2001:db8::1)
  • Full notation (2001:0db8:85a3:0000:0000:8a2e:0370:7334)
  • Link-local addresses (fe80::1234:5678:abcd:ef01)
  • IPv4-mapped IPv6 addresses (::ffff:192.168.1.1)
  • Zone identifiers (fe80::1%eth0)

Improved User Experience

• Enhanced command-line usage message with detailed help text and IPv6 examples
• Added interactive demonstration script (examples/ipv6_demonstration.py) for hands-on validation
• Clear explanations of when and how to use different IPv6 address formats

Code Quality

• All changes maintain backward compatibility
• Code passes linting and formatting checks
• Comprehensive validation of all documented examples

Example Usage

The tool now clearly documents support for various IPv6 formats:

# IPv6 localhost
poetry run python -m rew2streammagic.main example_data/default.txt ::1

# IPv6 global unicast address
poetry run python -m rew2streammagic.main example_data/peaking.txt 2001:db8::1

# IPv6 with zone identifier
poetry run python -m rew2streammagic.main example_data/filter_types.txt fe80::1%eth0

Run the demonstration script to see all supported formats:

python3 examples/ipv6_demonstration.py

This improvement provides users with clear, comprehensive guidance on using IPv6 addresses with StreamMagic devices, making the feature more accessible and easier to understand.

This pull request was created as a result of the following prompt from Copilot chat.

Improve the existing pull request by adding IPv6 examples to demonstrate the new IP address argument functionality. Ensure the examples are clear, concise, and provide adequate coverage for how to use the feature with IPv6 addresses. Update any relevant documentation or test cases to include these IPv6 examples.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.