chname 2.1.3__py3-none-any.whl → 2.1.6__py3-none-any.whl

chname/__main__.py

@@ -17,7 +17,7 @@ Options:
     -f, --fix=<maximum number of digits>       Fixes numerical file names
     -h, --help                                 Show this help screen
     -l, --lower                                Translates the filenames to lowercase
-    --merge                                    Merges the files in order specfied on command line
+    --merge                                    Merges the files in order specified on command line
     -o, --order                                Take any input files and fluxes them in numerical order
     -p, --prepend=<prefix>                     Prefix to be prepended
     --random                                   Randomizes the files
@@ -38,11 +38,13 @@ import sys
 
 from docopt import docopt
 
+arguments: dict = {}
 
-def main():
+
+def main() -> None:
     """Main Method"""
     global arguments
-    arguments = docopt(__doc__, version="chname 2.1.4")
+    arguments = docopt(__doc__, version="chname 2.1.6")
 
     if arguments["--test"]:
         arguments["--verbose"] = True
@@ -50,7 +52,7 @@ def main():
     flux(arguments["<files>"])
 
 
-def flux(files):
+def flux(files: list[str]) -> None:
     """Renames the specified files"""
 
     if arguments["--usage"] or not files:
@@ -75,9 +77,9 @@ def flux(files):
     sys.exit(0)
 
 
-def nameFilesByInputFile(files):
+def nameFilesByInputFile(files) -> None:
     """Names files by using an input text file"""
-    extension = calculateExtension(files)
+    extension: str = calculateExtension(files)
 
     with open(arguments["--titles"], "r") as fp:
         exportFileNames = [line.strip() for line in fp if line.strip()]
@@ -89,12 +91,12 @@ def nameFilesByInputFile(files):
             )
         )
 
-    filenameTemplate = (
+    filenameTemplate: str = (
         r"{num:02d} - {filename}{extension}" if len(files) < 100 else r"{num:04d} - {filename}{extension}"
     )
-    index = 1
+    index: int = 1
     for currentFilePath, newFileName in zip(files, exportFileNames):
-        newFilePath = os.path.join(
+        newFilePath: str = os.path.join(
             os.path.dirname(currentFilePath),
             filenameTemplate.format(num=index, filename=newFileName, extension=extension),
         )
@@ -102,48 +104,48 @@ def nameFilesByInputFile(files):
         index += 1
 
 
-def orderFiles(files):
+def orderFiles(files) -> None:
     """Orders the files"""
-    filenameTemplate = r"{num:02d} - {filename}" if len(files) < 100 else r"{num:04d} - {filename}"
+    filenameTemplate: str = r"{num:02d} - {filename}" if len(files) < 100 else r"{num:04d} - {filename}"
 
     for index, currentFilePath in enumerate(sorted(files), 1):
-        newFilePath = os.path.join(
+        newFilePath: str = os.path.join(
             os.path.dirname(currentFilePath),
             filenameTemplate.format(num=index, filename=os.path.basename(currentFilePath)),
         )
         rename_file(currentFilePath, newFilePath)
 
 
-def randomizeFiles(files):
+def randomizeFiles(files) -> None:
     """randomly shuffles a list of files with the same extension"""
 
     # determine the extension
-    extension = calculateExtension(files)
+    extension: str = calculateExtension(files)
 
     # do the shuffle
     random.shuffle(files)
 
-    prefix = arguments["--prepend"] if arguments["--prepend"] else "file"
+    prefix: str = arguments["--prepend"] if arguments["--prepend"] else "file"
 
     # rename the files in numeric order
     for index, filename in enumerate(files, 1):
-        new_file_name = os.path.join(
+        new_file_name: str = os.path.join(
             os.path.dirname(filename),
             "{prefix}_{num:04d}{extension}".format(prefix=prefix, num=index, extension=extension),
         )
         rename_file(filename, new_file_name)
 
 
-def mergeFiles(files):
+def mergeFiles(files) -> None:
     """reorders a set of files in order in a target directory"""
 
     if not arguments["--directory"]:
         raise SystemExit("--directory must be set")
 
     # determine the extension
-    extension = calculateExtension(files)
+    extension: str = calculateExtension(files)
 
-    prefix = arguments["--prepend"] if arguments["--prepend"] else "file"
+    prefix: str = arguments["--prepend"] if arguments["--prepend"] else "file"
 
     # rename the files in argument specified order
     for index, filename in enumerate(files, 1):
@@ -153,23 +155,23 @@ def mergeFiles(files):
         rename_file(filename, new_file_name)
 
 
-def calculateExtension(files):
+def calculateExtension(files) -> str:
     """determines a single extension"""
-    extensions = set((os.path.splitext(f)[1].lower() for f in files))
+    extensions: set[str] = set((os.path.splitext(f)[1].lower() for f in files))
     if len(extensions) > 1:
         raise SystemExit("Only one extension allowed. Found: {}".format(", ".join(extensions)))
 
     return extensions.pop()
 
 
-def performRenameOperation(fileName):
+def performRenameOperation(fileName) -> None:
     """Performs a renaming operation on the specified filename"""
     if not os.path.exists(fileName):
         if not arguments["--quiet"]:
             print("{} does not exist, skipping.".format(fileName), file=sys.stderr)
         return
 
-    newFileName = fileName
+    newFileName: str = fileName
 
     if arguments["--lower"]:
         newFileName = newFileName.lower()
@@ -195,7 +197,7 @@ def performRenameOperation(fileName):
         rename_file(fileName, newFileName)
 
 
-def rename_file(oldName, newName):
+def rename_file(oldName, newName) -> None:
     """Performs the actual file rename"""
     if arguments["--verbose"]:
         print("Renaming {} to {}".format(oldName, newName))
@@ -204,7 +206,7 @@ def rename_file(oldName, newName):
         os.rename(oldName, newName)
 
 
-def substitute(fileName, pattern):
+def substitute(fileName, pattern) -> str:
     """Performs the pattern substitution"""
     try:
         (old, new) = re.match(r"^(.*)/(.*)$", pattern).groups()
@@ -213,7 +215,7 @@ def substitute(fileName, pattern):
         raise SystemExit("chname: Illegal substitute pattern. Pattern must be old/new")
 
 
-def fixNumbers(fileName, delimiter, numberLength):
+def fixNumbers(fileName, delimiter, numberLength) -> str:
     """Fixes the numeric part of a filename"""
     if delimiter not in fileName:
         return fileName
@@ -221,7 +223,7 @@ def fixNumbers(fileName, delimiter, numberLength):
     (base, extension) = os.path.splitext(fileName)
     (prefix, number) = base.split(delimiter, 2)
 
-    sequenceValue = number
+    sequenceValue: str = number
 
     for i in range(len(number), int(numberLength)):
         sequenceValue = "0" + sequenceValue
@@ -229,7 +231,7 @@ def fixNumbers(fileName, delimiter, numberLength):
     return prefix + delimiter + sequenceValue + extension
 
 
-def usage():
+def usage() -> None:
     print(
         __doc__
         + """

{chname-2.1.3.dist-info → chname-2.1.6.dist-info}/METADATA

@@ -1,16 +1,22 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: chname
-Version: 2.1.3
+Version: 2.1.6
 Summary: Renames files in powerful ways
-License: MIT
+License-Expression: MIT
+License-File: LICENSE
+Keywords: rename,file,batch,bulk,utility,command-line,cli
 Author: Steve Scholnick
 Author-email: scholnicks@gmail.com
 Requires-Python: >=3.13
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Utilities
 Requires-Dist: docopt-ng (>=0.9.0,<0.10.0)
-Project-URL: Repository, https://github.com/scholnicks/chname
+Project-URL: Homepage, https://pypi.org/project/chname/
+Project-URL: Issues, https://github.com/scholnicks/chname/issues
+Project-URL: Repository, https://github.com/scholnicks/chname/
 Description-Content-Type: text/markdown
 
 # chname
@@ -28,7 +34,7 @@ Options:
     -f, --fix=<maximum number of digits>       Fixes numerical file names
     -h, --help                                 Show this help screen
     -l, --lower                                Translates the filenames to lowercase
-    --merge                                    Merges the files in order specfied on command line
+    --merge                                    Merges the files in order specified on command line
     -o, --order                                Take any input files and renames them in numerical order
     -p, --prepend=<prefix>                     Prefix to be prepended
     --random                                   Randomizes the files

chname-2.1.6.dist-info/RECORD

@@ -0,0 +1,7 @@
+chname/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chname/__main__.py,sha256=9sMa8VtOMt1I-xfnx2ujklgOgfdyKQCQOsQlv9yFvX0,8652
+chname-2.1.6.dist-info/METADATA,sha256=NJs9sQoPtVAEZD1pWUEfMXU4e4oLQ0kIhU3vCYVkP3Y,2517
+chname-2.1.6.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+chname-2.1.6.dist-info/entry_points.txt,sha256=l8ek6yn-OaGAak7ye2y-kPeGb6YMnYcwwHfQ1ygX6sk,47
+chname-2.1.6.dist-info/licenses/LICENSE,sha256=wT_mfbxynx42y5DZ0-Kuf_pie3PaQPeK5nXUL8_V1WQ,1073
+chname-2.1.6.dist-info/RECORD,,

{chname-2.1.3.dist-info → chname-2.1.6.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.3
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any

chname-2.1.3.dist-info/RECORD

@@ -1,7 +0,0 @@
-chname/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-chname/__main__.py,sha256=XgO4ct66Ml2sCVGB3CMIgFkQcmPEDnqBHyUDE8vNuAQ,8450
-chname-2.1.3.dist-info/LICENSE,sha256=wT_mfbxynx42y5DZ0-Kuf_pie3PaQPeK5nXUL8_V1WQ,1073
-chname-2.1.3.dist-info/METADATA,sha256=kyEYLgWR4Ya9-M5KrEQf3irZ5f6B3MIBB61I5k3Jcoo,2220
-chname-2.1.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-chname-2.1.3.dist-info/entry_points.txt,sha256=l8ek6yn-OaGAak7ye2y-kPeGb6YMnYcwwHfQ1ygX6sk,47
-chname-2.1.3.dist-info/RECORD,,