v0.8.0 - Version Management Simplification

[0.8.0] - 2025-01-26

🎉 Major Release: Version Management Simplification

This release aligns with the upcoming vCon draft specification by removing mandatory version management and enforcement, making the version field optional while maintaining full backward compatibility.

✨ Added

Flexible Versioning

• Optional Version Field: The vcon field is now optional in vCon objects
• Version Preservation: Existing vCons with version fields continue to work unchanged
• Simplified Creation: New vCons can be created without version fields

🔄 Changed

Version Management Simplification

• Removed strict_version Parameter: Eliminated from all Vcon methods (__init__, build_from_json, build_new, load, load_from_file, load_from_url)
• No Automatic Version Assignment: vCon objects no longer automatically get a version field
• No Version Migration: Removed automatic migration from older versions
• Updated Validation: The is_valid() method no longer requires the version field

Method Signatures Updated

• Vcon(vcon_dict=None, property_handling="default") - removed strict_version parameter
• build_from_json(json_str, property_handling="default") - removed strict_version parameter
• build_new(created_at=None, property_handling="default") - removed strict_version parameter
• load(source, property_handling="default") - removed strict_version parameter
• load_from_file(file_path, property_handling="default") - removed strict_version parameter
• load_from_url(url, property_handling="default") - removed strict_version parameter

🧪 Testing

Updated Test Suite

• Replaced Version Migration Tests: Updated tests to cover optional version field behavior
• New Test Cases: Added comprehensive tests for versionless vCon creation and preservation
• Backward Compatibility Tests: Ensured existing vCons with version fields continue to work

📄 Documentation

Updated Documentation

• README.md: Updated to reflect version field being optional
• API_REFERENCE.md: Removed strict_version parameter from all method signatures
• GUIDE.md: Updated examples to show versionless vCon creation
• MIGRATION_GUIDE.md: Added migration steps for version management changes

Updated Sample Files

• Removed Version Fields: All sample vCon JSON files updated to demonstrate versionless vCons
• Backward Compatibility: Existing vCons with version fields continue to work

🔧 Technical Details

Implementation Changes

• Removed Version Logic: Eliminated version checking, migration, and enforcement code
• Simplified Initialization: Streamlined vCon object creation process
• Preserved Functionality: All other features remain unchanged

Backward Compatibility

• Existing vCons: Continue to work without any changes
• Version Fields: Preserved when present, not added when absent
• API Compatibility: All other methods and properties remain unchanged

🎯 Benefits

1. Enhanced Flexibility: vCon objects can now exist without mandatory versioning
2. Simplified Implementation: Reduced complexity in version management
3. Better Privacy Support: Enables creation of redacted versions without version conflicts
4. Multiple Version Support: Allows different versions of the same vCon to coexist
5. Specification Compliance: Aligns with upcoming vCon draft specification

vCon 0.3.0 Specification Compliance

[0.7.0] - 2025-07-19

🎉 Major Release: Complete vCon 0.3.0 Specification Compliance

This release implements full compliance with the IETF vCon 0.3.0 specification, adding comprehensive support for all new fields, validation, and features while maintaining complete backward compatibility.

✨ Added

vCon Object Level Features

• Extensions Support:
  • extensions field for declaring extension capabilities
  • must_support field for specifying required extensions
  • Helper methods: add_extension(), remove_extension(), get_extensions()
  • Helper methods: add_must_support(), remove_must_support(), get_must_support()
  • Automatic duplicate prevention and validation

Enhanced Party Object Support

• New Contact Methods:
  • sip field for SIP URI contact information
  • did field for Decentralized Identifier (blockchain-based identity)
  • jCard field for vCard format contact information (RFC 7095)
  • timezone field for party timezone information
• Civic Address Support: Complete GEOPRIV specification compliance
  • All administrative areas (a1-a6)
  • Street and building information (sts, hno, hns, prd, flr)
  • Location and identification fields (country, pc, nam, lmk, loc, pod)

Enhanced Dialog Object Support

• Session Management:
  • session_id field for session tracking
  • content_hash field for content integrity verification (replaces alg/signature)
  • application field for application identification
  • message_id field for email/text dialog identification
• Content Integrity:
  • calculate_content_hash() method with SHA-256 support
  • verify_content_hash() method for integrity verification
  • Automatic content hash calculation for external files

Party History Event Tracking

• New PartyHistory Class: Complete implementation of party history events
  • Support for all 6 specification event types: join, drop, hold, unhold, mute, unmute
  • Event validation with VALID_EVENTS list
  • ISO 8601 time serialization for all events
  • Proper error handling for invalid events

Enhanced Media Type Support

• Specification-Compliant Media Types:
  • Added audio/x-mp3 and audio/x-mp4 (specification required)
  • Enhanced video format support (MP4, WebM, AVI, MKV, MOV, FLV, 3GP)
  • Complete audio format coverage (WAV, MP3, MP4, OGG, WebM, AAC)
  • Image and document support (JPEG, TIFF, PDF)

Disposition Values for Incomplete Dialogs

• Complete Disposition Support: All 6 specification values implemented
  • no-answer: Call attempted but no answer
  • congestion: System load prevented completion
  • failed: Call/connection failed
  • busy: Party was busy
  • hung-up: Party hung up before conversation
  • voicemail-no-message: Voicemail answered but no message left
• Validation: Automatic validation for incomplete dialog types

Transfer Dialog Enhancements

• Updated Field Names: Consistent underscore naming convention
  • transfer-target → transfer_target
  • target-dialog → target_dialog
• Enhanced Transfer Support: Complete transfer operation tracking

Comprehensive Documentation

• Updated Class Documentation: Complete docstrings for all classes
  • Vcon class with vCon 0.3.0 feature documentation
  • Party class with new contact method documentation
  • Dialog class with session and content hash documentation
  • CivicAddress class with GEOPRIV compliance documentation
  • PartyHistory class with event tracking documentation
• Enhanced README: Comprehensive usage examples and feature documentation
• API Documentation: Complete API reference with examples

🔧 Changed

Property Handling

• Updated Allowed Properties: All new fields added to property lists
  • _ALLOWED_VCON_PROPERTIES: Added extensions, must_support
  • _ALLOWED_PARTY_PROPERTIES: Added sip, did, jCard, timezone
  • _ALLOWED_DIALOG_PROPERTIES: Added session_id, content_hash, application, message_id
• Enhanced Property Processing: Improved handling in all modes (default, strict, meta)

Validation Enhancements

• Comprehensive Validation: Enhanced validation for all new fields
  • Party history event validation
  • Disposition value validation for incomplete dialogs
  • Media type validation with specification compliance
  • Civic address field validation
• Backward Compatibility: All validation maintains backward compatibility

Serialization Improvements

• ISO 8601 Compliance: All datetime fields properly serialized
• Content Hash Integration: Automatic content hash calculation and verification
• Extension Management: Proper serialization of extensions and must_support fields

🧪 Testing

Comprehensive Test Coverage

• 149 Tests Passing: Complete test suite with 7 skipped (advanced features)
• New Feature Tests: Extensive testing for all new vCon 0.3.0 features
  • Party history event validation tests
  • Disposition value validation tests
  • Media type validation tests
  • Extension management tests
  • Content hash calculation tests
• Backward Compatibility Tests: Verification that existing functionality works unchanged
• Validation Tests: Comprehensive validation testing for all new fields

📚 Documentation

Complete Documentation Update

• Class Documentation: Updated all class docstrings with vCon 0.3.0 features
• README Enhancement: Comprehensive usage examples and feature documentation
• API Reference: Complete API documentation with examples
• Workplan Documentation: Complete implementation tracking in IETF-123-WORKPLAN.md

🔄 Migration Support

Version Migration

• Automatic Migration: Seamless migration from older vCon versions
• Strict Mode Support: Optional strict version checking
• Backward Compatibility: Full compatibility with existing vCon files

🔑 Security

Enhanced Security Features

• Content Integrity: SHA-256 content hashing for external files
• Digital Signatures: JWS support for vCon signing
• Validation: Comprehensive validation for all security-related fields

📄 Sample Files

Updated Sample Files

• Version 0.3.0 Compliance: All sample files updated to vCon 0.3.0
• New Field Examples: Sample files demonstrating new features
• Backward Compatibility: Existing sample files continue to work

🔧 Technical Details

Implementation Quality

• 149 Tests Passing: Comprehensive test coverage
• Zero Breaking Changes: Complete backward compatibility
• Specification Compliance: Full vCon 0.3.0 specification implementation
• Performance: Optimized implementation with minimal overhead
• Error Handling: Comprehensive error handling and validation

Code Quality

• Type Hints: Complete type annotation coverage
• Documentation: Comprehensive docstrings and comments
• Linting: Clean code with minimal linting issues
• Modularity: Well-structured, maintainable code

---

0.6.0

Adds video and image support.

v0.5.0

Full Changelog: v0.4.1...v0.5.0

v0.4.1

What's Changed

• Bump package version to 0.4.1 and update Python requirement by @howethomas in #28

Full Changelog: v0.4.0...v0.4.1

v0.4.0

What's Changed

• Valid by @howethomas in #25
• Add sample vCon scripts and example files demonstrating library usage by @howethomas in #26
• Add vCon loading and validation methods by @howethomas in #27

Full Changelog: v0.3.10...v0.4.0

v0.3.10

Add documentation infrastructure and Sphinx configuration

• Create comprehensive documentation structure with Sphinx
• Add GitHub Actions workflow for documentation deployment
• Configure Sphinx with Read the Docs theme
• Create initial documentation source files (index, installation, usage)
• Add API reference generation configuration
• Include draft IETF document in docs folder
• Update pyproject.toml to include Sphinx and documentation dependencies

v0.3.9

Version 0.3.9

Changes

• Updated the __init__ methods in Dialog and Party classes to accept additional keyword arguments
• Simplified attribute assignment using locals() for non-None values
• Enhanced the to_dict method in Dialog to return all non-None attributes
• Improved code structure and readability
• Added better method and parameter documentation

Dependencies

• No changes to dependencies

v0.3.8

Changes in this release:

• Updated the __init__ methods in Dialog and Party classes to accept additional keyword arguments
• Simplified attribute assignment using locals() for non-None values
• Enhanced the to_dict method in Dialog to return all non-None attributes
• Improved code structure and readability
• Added improved docstrings for better documentation

Release v0.3.7

Release v0.3.7
• Enhanced Dialog and Party classes:
• init methods now accept **kwargs for added flexibility.
• Simplified attribute assignment using locals() for non-None values.
• Improved to_dict in Dialog to include all non-None attributes.
• Improved code readability, structure, and consistency.
• Added comprehensive docstrings for better documentation.
• Dependencies Updated:
• Bumped cryptography to 43.0.1.
• Added mutagen (1.47.0) for audio handling.
• Upgraded pytest to 8.3.4 for enhanced testing.
• Refactored test_vcon.py:
• Introduced type hinting for get_audio_duration.
• Improved test clarity with formatting adjustments, inline comments, and consistent spacing.
• Refactored long strings in test cases for better readability.

This release focuses on enhanced flexibility, maintainability, and improved testing support.