cliTools: Utilities for command-line interfaces and console scripts¶
Collection of utilities for command-line interfaces and console scripts.
-
fontTools.misc.cliTools.
makeOutputFileName
(input, outputDir=None, extension=None, overWrite=False)[source]¶ Generates a suitable file name for writing output.
Often tools will want to take a file, do some kind of transformation to it, and write it out again. This function determines an appropriate name for the output file, through one or more of the following steps:
changing the output directory
replacing the file extension
suffixing the filename with a number (
#1
,#2
, etc.) to avoid overwriting an existing file.
- Parameters
input – Name of input file.
outputDir – Optionally, a new directory to write the file into.
extension – Optionally, a replacement for the current file extension.
overWrite – Overwriting an existing file is permitted if true; if false and the proposed filename exists, a new name will be generated by adding an appropriate number suffix.
- Returns
Suitable output filename
- Return type
str