podcast-dl 7.1.0 → 7.2.0

package/README.md

@@ -1,6 +1,6 @@
 # podcast-dl
 
-## A CLI for downloading podcasts with a focus on archiving.
+A CLI for downloading podcasts with a focus on archiving.
 
 ## How to Use
 
@@ -10,6 +10,8 @@
 
 `npx podcast-dl --url <PODCAST_RSS_URL>`
 
+### [More Examples](./docs/examples.md)
+
 ## Options
 
 Type values surrounded in square brackets (`[]`) can be used as used as boolean options (no argument required).
@@ -18,6 +20,7 @@ Type values surrounded in square brackets (`[]`) can be used as used as boolean
 | ------------------------ | ------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | --url                    | String              | true     | URL to podcast RSS feed.                                                                                                                                                                                              |
 | --out-dir                | String              | false    | Specify output directory for episodes and metadata. Defaults to "./{{podcast_title}}". See "Templating" for more details.                                                                                             |
+| --threads                | Number              | false    | Determines the number of downloads that will happen concurrently. Default is 1.                                                                                                                                       |
 | --archive                | [String]            | false    | Download or write out items not listed in archive file. Generates archive file at path if not found. Defaults to "./{{podcast_title}}/archive.json" when used as a boolean option. See "Templating" for more details. |
 | --episode-template       | String              | false    | Template for generating episode related filenames. See "Templating" for details.                                                                                                                                      |
 | --include-meta           |                     | false    | Write out podcast metadata to JSON.                                                                                                                                                                                   |
@@ -36,7 +39,6 @@ Type values surrounded in square brackets (`[]`) can be used as used as boolean
 | --info                   |                     | false    | Print retrieved podcast info instead of downloading.                                                                                                                                                                  |
 | --list                   | [String]            | false    | Print episode list instead of downloading. Defaults to "table" when used as a boolean option. "json" is also supported.                                                                                               |
 | --exec                   | String              | false    | Execute a command after each episode is downloaded.                                                                                                                                                                   |
-| --threads                | Number              | false    | Determines the number of downloads that will happen concurrently. Default is 1.                                                                                                                                       |
 | --filter-url-tacking     |                     | false    | Attempts to extract the direct download link of an episode if detected (**experimental**).                                                                                                                            |
 | --version                |                     | false    | Output the version number.                                                                                                                                                                                            |
 | --help                   |                     | false    | Output usage information.                                                                                                                                                                                             |

package/bin/async.js

@@ -16,6 +16,7 @@ import { getArchiveFilename, getFilename } from "./naming.js";
 import {
   getEpisodeAudioUrlAndExt,
   getArchiveKey,
+  getTempPath,
   runFfmpeg,
   runExec,
   writeItemMeta,
@@ -63,9 +64,10 @@ const download = async ({
     },
   });
 
+  const tempOutputPath = getTempPath(outputPath);
   const removeFile = () => {
-    if (fs.existsSync(outputPath)) {
-      fs.unlinkSync(outputPath);
+    if (fs.existsSync(tempOutputPath)) {
+      fs.unlinkSync(tempOutputPath);
     }
   };
 
@@ -101,14 +103,14 @@ const download = async ({
 
     await pipeline(
       got.stream(finalUrl).on("downloadProgress", onDownloadProgress),
-      fs.createWriteStream(outputPath)
+      fs.createWriteStream(tempOutputPath)
     );
   } catch (error) {
     removeFile();
     throw error;
   }
 
-  const fileSize = fs.statSync(outputPath).size;
+  const fileSize = fs.statSync(tempOutputPath).size;
 
   if (fileSize === 0) {
     removeFile();
@@ -121,6 +123,8 @@ const download = async ({
     return;
   }
 
+  fs.renameSync(tempOutputPath, outputPath);
+
   if (expectedSize && !isNaN(expectedSize) && expectedSize !== fileSize) {
     logMessage(
       "File size differs from expected content length. Suggestion: verify file works as expected",

package/bin/util.js

@@ -15,6 +15,10 @@ const parser = new rssParser({
   defaultRSS: 2.0,
 });
 
+const getTempPath = (path) => {
+  return `${path}.tmp`;
+};
+
 const getArchiveKey = ({ prefix, name }) => {
   return `${prefix}-${name}`;
 };
@@ -569,6 +573,7 @@ export {
   getFeed,
   getImageUrl,
   getItemsToDownload,
+  getTempPath,
   getUrlExt,
   getUrlEmbed,
   logFeedInfo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "podcast-dl",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "description": "A CLI for downloading podcasts.",
   "type": "module",
   "bin": "./bin/bin.js",