feat: expose --port cli flag

Author: simonhaenisch

cli.ts

@@ -32,6 +32,7 @@ const cliFlags = arg({
 	'--html-pdf-options': String,
 	'--pdf-options': String,
 	'--launch-options': String,
+	'--port': Number,
 	'--md-file-encoding': String,
 	'--stylesheet-encoding': String,
 	'--as-html': Boolean,
@@ -96,12 +97,12 @@ async function main(args: typeof cliFlags, config: Config) {
 	}
 
 	// serve directory of first file because all files will be in the same dir
-	const port = await getPort();
-	const server = await serveDirectory(getDir(mdFiles[0]), port);
+	config.port = args['--port'] || (await getPort());
+	const server = await serveDirectory(getDir(mdFiles[0]), config.port);
 
 	const getListrTask = (mdFile: string) => ({
 		title: `generating ${args['--as-html'] ? 'HTML' : 'PDF'} from ${chalk.underline(mdFile)}`,
-		task: () => convertMdToPdf(mdFile, config, port, args),
+		task: () => convertMdToPdf(mdFile, config, args),
 	});
 
 	// create list of tasks and run concurrently

index.ts

@@ -17,16 +17,16 @@ export const mdToPdf = async (mdFile: string, config: Partial<Config> = {}) => {
 		throw new TypeError(`mdFile has to be a string, received ${typeof mdFile}`);
 	}
 
-	const port = await getPort();
-	const server = await serveDirectory(getDir(mdFile), port);
+	config.port = config.port || (await getPort());
+	const server = await serveDirectory(getDir(mdFile), config.port);
 
 	const mergedConfig: Config = {
 		...defaultConfig,
 		...config,
 		pdf_options: { ...defaultConfig.pdf_options, ...config.pdf_options },
 	};
 
-	const pdf = await convertMdToPdf(mdFile, mergedConfig, port);
+	const pdf = await convertMdToPdf(mdFile, mergedConfig);
 
 	server.close();
 

lib/help.ts

@@ -15,6 +15,7 @@ const helpText = `
     --marked-options ${chalk.dim('.........')} Set custom options for marked (as a JSON string)
     --pdf-options ${chalk.dim('............')} Set custom options for the generated PDF (as a JSON string)
     --launch-options ${chalk.dim('.........')} Set custom launch options for Puppeteer
+    --port ${chalk.dim('...................')} Set the port to run the http server on
     --md-file-encoding ${chalk.dim('.......')} Set the file encoding for the markdown file
     --stylesheet-encoding ${chalk.dim('....')} Set the file encoding for the stylesheet
     --as-html ${chalk.dim('................')} Output as HTML instead

lib/md-to-pdf.ts

@@ -10,7 +10,7 @@ import { getMarginObject } from './helpers';
 /**
  * Convert a markdown file to pdf.
  */
-export const convertMdToPdf = async (mdFile: string, config: Config, port: number, args: any = {}) => {
+export const convertMdToPdf = async (mdFile: string, config: Config, args: any = {}) => {
 	const mdFileContent = await readFile(resolve(mdFile), args['--md-file-encoding'] || config.md_file_encoding);
 
 	const { content: md, data: frontMatterConfig } = grayMatter(mdFileContent);
@@ -59,7 +59,7 @@ export const convertMdToPdf = async (mdFile: string, config: Config, port: numbe
 
 	const html = getHtml(md, config);
 
-	const output = await writeOutput(mdFile, html, { ...config, port });
+	const output = await writeOutput(mdFile, html, config);
 
 	if (!output.filename) {
 		throw new Error(`Failed to create ${config.as_html ? 'HTML' : 'PDF'}.`);