Merge pull request #9 from kiwilan/develop

1.0.12

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.0.11",
+    "version": "1.0.12",
     "keywords": [
         "php",
         "ebook",

src/Tools/MetaTitle.php

@@ -20,6 +20,7 @@ protected function __construct(
         protected ?string $serieSlugLang = null,
 
         protected ?string $slugSortWithSerie = null,
+        protected ?string $uniqueFilename = null,
     ) {
     }
 
@@ -74,6 +75,7 @@ private function setMetaTitle(Ebook $ebook): static
         $this->serieSlug = $this->setSlug($series);
         $this->serieSlugSort = $this->generateSortTitle($series, $language);
         $this->serieSlugLang = $this->generateSlug($series, $ebook->extension(), $language);
+        $this->uniqueFilename = $this->generateUniqueFilename($ebook);
 
         return $this;
     }
@@ -135,6 +137,14 @@ public function slugSortWithSerie(): string
         return $this->slugSortWithSerie;
     }
 
+    /**
+     * Get unique filename, like `jean-m-auel-earths-children-01-clan-of-the-cave-bear-en`.
+     */
+    public function uniqueFilename(): string
+    {
+        return $this->uniqueFilename;
+    }
+
     /**
      * Try to get sort title.
      * Example: `collier-de-la-reine` from `Le Collier de la Reine`.
@@ -196,6 +206,24 @@ private function generateSlug(string $title, ?string $type, ?string $language):
         return $this->setSlug($title.' '.$type.' '.$language);
     }
 
+    /**
+     * Generate unique filename.
+     */
+    private function generateUniqueFilename(Ebook $ebook): string
+    {
+        $author = $this->setSlug($ebook->authorMain());
+        $series = $this->setSlug($ebook->series());
+        $volume = (string) $ebook->volume();
+        $volume = $volume = strlen($volume) < 2 ? '0'.$volume : $volume;
+        $title = $this->setSlug($ebook->title());
+        $language = $this->setSlug($ebook->language());
+
+        $filename = "{$author}-{$series}-{$volume}-{$title}-{$language}";
+        $filename = $this->setSlug($filename);
+
+        return $filename;
+    }
+
     public function toArray(): array
     {
         return [

tests/MetaTitleTest.php

@@ -19,4 +19,5 @@
     expect($meta->serieSlugSort())->toBe('a-comme-association');
     expect($meta->serieSlugLang())->toBe('a-comme-association-epub-fr');
     expect($meta->slugSortWithSerie())->toBe('a-comme-association-01_pale-lumiere-des-tenebres');
+    expect($meta->uniqueFilename())->toBe('jean-m-auel-a-comme-association-01-la-pale-lumiere-des-tenebres-fr');
 });