Add media:description to media:group #172

Author: nmdias

Sources/FeedKit/Namespaces/Media/MediaGroup.swift

@@ -35,12 +35,14 @@ public struct MediaGroup {
     contents: [MediaContent]? = nil,
     credits: [MediaCredit]? = nil,
     category: MediaCategory? = nil,
-    rating: MediaRating? = nil
+    rating: MediaRating? = nil,
+    description: MediaDescription? = nil
   ) {
     self.contents = contents
     self.credits = credits
     self.category = category
     self.rating = rating
+    self.description = description
   }
 
   // MARK: Public
@@ -68,6 +70,10 @@ public struct MediaGroup {
   /// included, it assumes that no restrictions are necessary. It has one
   /// optional attribute.
   public var rating: MediaRating?
+
+  /// Short description describing the media object typically a sentence in
+  /// length. It has one optional attribute.
+  public var description: MediaDescription?
 }
 
 // MARK: - Sendable
@@ -90,6 +96,7 @@ extension MediaGroup: Codable {
     case credits = "media:credit"
     case category = "media:category"
     case rating = "media:rating"
+    case description = "media:description"
   }
 
   public init(from decoder: any Decoder) throws {
@@ -99,6 +106,7 @@ extension MediaGroup: Codable {
     credits = try container.decodeIfPresent([MediaCredit].self, forKey: MediaGroup.CodingKeys.credits)
     category = try container.decodeIfPresent(MediaCategory.self, forKey: MediaGroup.CodingKeys.category)
     rating = try container.decodeIfPresent(MediaRating.self, forKey: MediaGroup.CodingKeys.rating)
+    description = try container.decodeIfPresent(MediaDescription.self, forKey: MediaGroup.CodingKeys.description)
   }
 
   public func encode(to encoder: any Encoder) throws {
@@ -108,5 +116,6 @@ extension MediaGroup: Codable {
     try container.encodeIfPresent(credits, forKey: MediaGroup.CodingKeys.credits)
     try container.encodeIfPresent(category, forKey: MediaGroup.CodingKeys.category)
     try container.encodeIfPresent(rating, forKey: MediaGroup.CodingKeys.rating)
+    try container.encodeIfPresent(description, forKey: MediaGroup.CodingKeys.description)
   }
 }

Tests/FeedKitTests/Resources/xml/Media.xml

@@ -10,6 +10,7 @@
         <media:credit role="owner" scheme="urn:yvs">copyright holder of the entity</media:credit>
         <media:category scheme="http://dmoz.org" label="Ace Ventura - Pet Detective">music/artist name/album/song</media:category>
         <media:rating scheme="urn:mpaa">nonadult</media:rating>
+        <media:description>What a wonderful description he found</media:description>
       </media:group>
       <media:content url="http://www.foo.com/video.mov" fileSize="12216320" type="video/quicktime" medium="video" isDefault="true" expression="full" bitrate="128" framerate="25" samplingrate="44.1" channels="2" duration="185" height="300" width="200" lang="en">
       </media:content>

Tests/FeedKitTests/Tests/MediaTests + Mocks.swift

@@ -118,6 +118,10 @@ extension MediaTests {
         attributes: .init(
           scheme: "urn:mpaa"
         )
+      ),
+      description: .init(
+        text: "What a wonderful description he found",
+        attributes: nil
       )
     )