Add new() method to vCalAddress class (fixes #870)

[SashankBhamidi]

This PR implements the method for the class to provide a consistent API with other icalendar components like .

Changes Made

✅ vCalAddress.new() method implementation:

• Email as first positional parameter
• Automatic mailto: prefix handling (adds if missing)
• All RFC 5545 parameters supported: CN, CUTYPE, DELEGATED-FROM, DELEGATED-TO, DIR, LANGUAGE, PARTSTAT, ROLE, RSVP, SENT-BY
• Consistent with Event.new() pattern

✅ Comprehensive test suite:

• 25 test cases covering all parameters and edge cases
• Integration test with Event attendees
• Error condition testing
• Example usage demonstrations

✅ Documentation:

• Detailed docstring with parameter descriptions
• Usage examples in docstring
• RFC 5545 compliance maintained

Example Usage

# Basic usage
addr = vCalAddress.new("user@example.com")

# With parameters
addr = vCalAddress.new(
    "chair@example.com",
    cn="Meeting Chair",
    role="CHAIR",
    rsvp=True
)

# Integration with Event
event = Event.new(summary="Meeting", start=datetime(2026, 1, 1, 12, 0))
attendee = vCalAddress.new("attendee@example.com", cn="John Doe", partstat="ACCEPTED")
event.add("ATTENDEE", attendee)

Testing

All tests pass (25/25) and maintain backward compatibility.

Fixes #870

---

📚 Documentation preview 📚: https://icalendar--882.org.readthedocs.build/

[SashankBhamidi]

All requirements from Issue #870 implemented. Ready for merge.

[coveralls]

Pull Request Test Coverage Report for Build 16389578345

Details

• 120 of 120 (100.0%) changed or added relevant lines in 2 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage increased (+0.04%) to 97.482%

---

Totals
Change from base Build 16389139167:	0.04%
Covered Lines:	7114
Relevant Lines:	7287

---

💛 - Coveralls

[SashankBhamidi]

Looking into the nopytz test failure.

[SashankBhamidi]

Ready for merge

• nopytz test failure resolved (missing import in doctest)
• All review feedback addressed
• 36 tests passing

Implementation complete for #870

[SashankBhamidi]

@niccokunzmann Could you please review and merge when ready? This would help me continue work on PR #881 without merge conflicts.

[niccokunzmann]

Thanks, this is nice!