File naming is Configuration driven: Configuration, AudioFileStorageExt, Templates, TemplateTags,

LibationFileManager/Configuration.cs

@@ -145,8 +145,40 @@ namespace LibationFileManager
         {
             get => persistentDictionary.GetNonString<bool>(nameof(DownloadEpisodes));
             set => persistentDictionary.SetNonString(nameof(DownloadEpisodes), value);
+		}
+
+        [Description("How to format the folders in which files will be saved")]
+		public string FolderTemplate
+        {
+            get => getTemplate(nameof(FolderTemplate), Templates.Folder);
+            set => setTemplate(nameof(FolderTemplate), Templates.Folder, value);
         }
 
+        [Description("How to format the saved pdf and audio files")]
+		public string FileTemplate
+        {
+            get => getTemplate(nameof(FileTemplate), Templates.File);
+            set => setTemplate(nameof(FileTemplate), Templates.File, value);
+        }
+
+        [Description("How to format the saved audio files which are split by chapters")]
+        public string ChapterFileTemplate
+        {
+            get => getTemplate(nameof(ChapterFileTemplate), Templates.ChapterFile);
+            set => setTemplate(nameof(ChapterFileTemplate), Templates.ChapterFile, value);
+        }
+
+        private string getTemplate(string settingName, Templates templ)
+        {
+            var value = persistentDictionary.GetString(settingName).Trim();
+            return templ.IsValid(value) ? value : templ.DefaultTemplate;
+        }
+        private void setTemplate(string settingName, Templates templ, string newValue)
+        {
+            var template = newValue.Trim();
+            if (templ.IsValid(template))
+                persistentDictionary.SetString(settingName, template);
+        }
         #endregion
 
         #region known directories

LibationFileManager/TemplateTags.cs

@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Dinah.Core;
+
+namespace LibationFileManager
+{
+    public sealed class TemplateTags : Enumeration<TemplateTags>
+    {
+        public string TagName => DisplayName;
+        public string Description { get; }
+        public bool IsChapterOnly { get; }
+
+        private static int value = 0;
+        private TemplateTags(string tagName, string description, bool isChapterOnly = false) : base(value++, tagName)
+        {
+            Description = description;
+            IsChapterOnly = isChapterOnly;
+        }
+
+        public static TemplateTags Id { get; } = new TemplateTags("id", "Audible ID");
+        public static TemplateTags Title { get; } = new TemplateTags("title", "Full title");
+        public static TemplateTags TitleShort { get; } = new TemplateTags("title short", "Title. Stop at first colon");
+        public static TemplateTags Author { get; } = new TemplateTags("author", "Author(s)");
+        public static TemplateTags FirstAuthor { get; } = new TemplateTags("first author", "First author");
+        public static TemplateTags Narrator { get; } = new TemplateTags("narrator", "Narrator(s)");
+        public static TemplateTags FirstNarrator { get; } = new TemplateTags("first narrator", "First narrator");
+        public static TemplateTags SeriesName { get; } = new TemplateTags("series name", "Name of series");
+        // can't also have a leading zeros version. Too many weird edge cases. Eg: "1-4"
+        public static TemplateTags SeriesNumber { get; } = new TemplateTags("series#", "Number order in series");
+
+        public static TemplateTags ChCount { get; } = new TemplateTags("ch count", "Number of chapters", true);
+        public static TemplateTags ChTitle { get; } = new TemplateTags("ch title", "Chapter title", true);
+        public static TemplateTags ChNumber { get; } = new TemplateTags("ch#", "Chapter number", true);
+        public static TemplateTags ChNumber0 { get; } = new TemplateTags("ch# 0", "Chapter number with leading zeros", true);
+    }
+}

LibationFileManager/Templates.cs

@@ -0,0 +1,88 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace LibationFileManager
+{
+    public abstract class Templates
+    {
+        public static Templates Folder { get; } = new FolderTemplate();
+        public static Templates File { get; } = new FileTemplate();
+        public static Templates ChapterFile { get; } = new ChapterFileTemplate();
+
+        public abstract string DefaultTemplate { get; }
+
+        public abstract bool IsValid(string template);
+        public abstract bool IsRecommended(string template);
+        public abstract int TagCount(string template);
+
+        public static bool ContainsChapterOnlyTags(string template)
+            => TemplateTags.GetAll()
+            .Where(t => t.IsChapterOnly)
+            .Any(t => ContainsTag(template, t.TagName));
+
+        public static bool ContainsTag(string template, string tag) => template.Contains($"<{tag}>");
+
+        protected static bool fileIsValid(string template)
+            // File name only; not path. all other path chars are valid enough to pass this check and will be handled on final save.
+            // null is invalid. whitespace is valid but not recommended
+            => template is not null
+            && !template.Contains(':')
+            && !template.Contains(System.IO.Path.DirectorySeparatorChar)
+            && !template.Contains(System.IO.Path.AltDirectorySeparatorChar);
+
+        protected bool isRecommended(string template, bool isChapter)
+            => IsValid(template)
+            && !string.IsNullOrWhiteSpace(template)
+            && TagCount(template) > 0
+            && ContainsChapterOnlyTags(template) == isChapter;
+
+        protected static int tagCount(string template, Func<TemplateTags, bool> func)
+            => TemplateTags.GetAll()
+            .Where(func)
+            // for <id><id> == 1, use:
+            //   .Count(t => template.Contains($"<{t.TagName}>"))
+            // .Sum() impl: <id><id> == 2
+            .Sum(t => template.Split($"<{t.TagName}>").Length - 1);
+
+        private class FolderTemplate : Templates
+        {
+			public override string DefaultTemplate { get; } = "<title short> [<id>]";
+
+			public override bool IsValid(string template)
+                // must be relative. no colons. all other path chars are valid enough to pass this check and will be handled on final save.
+                // null is invalid. whitespace is valid but not recommended
+                => template is not null
+                && !template.Contains(':');
+
+            public override bool IsRecommended(string template) => isRecommended(template, false);
+
+            public override int TagCount(string template) => tagCount(template, t => !t.IsChapterOnly);
+        }
+
+        private class FileTemplate : Templates
+        {
+			public override string DefaultTemplate { get; } = "<title> [<id>]";
+
+            public override bool IsValid(string template) => fileIsValid(template);
+
+            public override bool IsRecommended(string template) => isRecommended(template, false);
+
+            public override int TagCount(string template) => tagCount(template, t => !t.IsChapterOnly);
+        }
+
+        private class ChapterFileTemplate : Templates
+        {
+            public override string DefaultTemplate { get; } = "<title> [<id>] - <ch# 0> - <ch title>";
+
+            public override bool IsValid(string template) => fileIsValid(template);
+
+            public override bool IsRecommended(string template)
+                => isRecommended(template, true)
+                // recommended to incl. <ch#> or <ch# 0>
+                && (ContainsTag(template, TemplateTags.ChNumber.TagName) || ContainsTag(template, TemplateTags.ChNumber0.TagName));
+
+            public override int TagCount(string template) => tagCount(template, t => true);
+        }
+    }
+}

LibationFileManager/_InternalsVisible.cs

@@ -0,0 +1 @@
+[assembly: System.Runtime.CompilerServices.InternalsVisibleTo(nameof(LibationFileManager) + ".Tests")]