1.3.31

- improve `toArray()` for `EpubMetadata`
- add `limit` option to `copyright` and `description`

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "kiwilan/php-ebook",
     "description": "PHP package to read metadata and extract covers from eBooks (.epub, .cbz, .cbr, .cb7, .cbt, .pdf) and audiobooks (.mp3, .m4a, .m4b, .flac, .ogg).",
-    "version": "1.3.30",
+    "version": "1.3.31",
     "keywords": [
         "php",
         "ebook",

src/Ebook.php

@@ -250,6 +250,7 @@ public function toXml(string $path): ?string
      */
     public function title(): ?string
     {
+
         return $this->title;
     }
 
@@ -284,8 +285,12 @@ public function authors(): array
     /**
      * Description of the book.
      */
-    public function description(): ?string
+    public function description(?int $limit = null): ?string
     {
+        if ($limit) {
+            return $this->limitLength($this->description, $limit);
+        }
+
         return $this->description;
     }
 
@@ -294,6 +299,7 @@ public function description(): ?string
      */
     public function publisher(): ?string
     {
+
         return $this->publisher;
     }
 
@@ -338,6 +344,7 @@ public function tags(): array
      */
     public function series(): ?string
     {
+
         return $this->series;
     }
 
@@ -352,8 +359,12 @@ public function volume(): ?int
     /**
      * Copyright of the book.
      */
-    public function copyright(): ?string
+    public function copyright(?int $limit = null): ?string
     {
+        if ($limit) {
+            return $this->limitLength($this->copyright, $limit);
+        }
+
         return $this->copyright;
     }
 
@@ -515,6 +526,15 @@ public function hasCover(): bool
         return $this->cover !== null;
     }
 
+    private function limitLength(string $string, int $length): string
+    {
+        if (mb_strlen($string) <= $length) {
+            return $string;
+        }
+
+        return mb_substr($string, 0, $length - 1).'…';
+    }
+
     public function setTitle(?string $title): self
     {
         $this->title = $title;