lsseq 4.3.0__tar.gz → 4.3.1__tar.gz

{lsseq-4.3.0 → lsseq-4.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lsseq
-Version: 4.3.0
+Version: 4.3.1
 Summary: ls-like command for image-sequences
 Home-page: https://github.com/jrowellfx/lsseq
 Author: James Philip Rowell
@@ -94,6 +94,8 @@ however it can print sequences in a variety of formats useful for `nuke`,
 ```
     python3 -m pip install lsseq --upgrade
 ```
+If installing locally, it's probably best to install in a virtual-environment
+or [`venv`](https://docs.python.org/3/library/venv.html). 
 
 There is additional installation-information in an
 [addendum](https://github.com/jrowellfx/lsseq#addendum---more-on-installing-command-line-tools)
@@ -267,7 +269,7 @@ extend `lsseq's` capability.
     bbb/bbx.[0097-0103].tif
     bbb/bby.[0197-0203].tif
 
-    5$ lsseq --prepend-path-abs --skip-missing --format rv *
+    5$ lsseq --prepend-path-abs --format rv *
     /user/jrowellfx/test/ccc.0101.exr
     /user/jrowellfx/test/aaa/aaa.97-103@@@.tif
     /user/jrowellfx/test/bbb/bbx.97-103#.tif
@@ -318,12 +320,13 @@ the following EXIT codes will be combined bitwise to return
 possibly more than one different warning and/or error.
 
 ```
-EXIT_NO_ERROR               = 0 # Clean exit.
-EXIT_LS_ERROR               = 1 # A call to 'ls' returned an error code.
-EXIT_ARGPARSE_ERROR         = 2 # A bad option was passed to lsseq. Exit lsseq.
-EXIT_LSSEQ_SOFTLINK_WARNING = 4 # warning - broken softlink found
-EXIT_LSSEQ_PADDING_WARNING  = 8 # warning - two images with same name, same frame-num, but diff padding
-EXIT_CD_PERMISSION_WARNING  = 16 # warning - recursive descent blocked - no execute permission on dir
+EXIT_NO_ERROR                 =  0 # Clean exit.
+EXIT_LS_WARNING               =  1 # A call to 'ls' returned an error or another internal issue
+EXIT_ARGPARSE_ERROR           =  2 # The default code that argparse exits with if bad option.
+EXIT_LSSEQ_SOFTLINK_WARNING   =  4 # warning - broken softlink
+EXIT_LSSEQ_PADDING_WARNING    =  8 # warning - two images with same name, same frame-num, diff padding
+EXIT_CD_PERMISSION_WARNING    = 16 # warning - recursive descent blocked - no execute permission on dir
+EXIT_LSSEQ_NOSUCHFILE_WARNING = 32 # A non-existent sequence-file was listed on the command line.
 ```
 
 ## `lsseq --help`
@@ -530,7 +533,10 @@ LS(1) control for non-sequences:
   --directory, -d       list directory entries instead of contents, and do not
                         follow symbolic links (see LS(1))
   --classify, -F        append indicator (one of */=>@|) to entries, and do
-                        not follow symbolic links. (see LS(1))
+                        not follow symbolic links to directories. (see LS(1)
+                        for the meanings of the symbols.) Note: the '@' will
+                        also be appended to any sequences made up of symbolic
+                        links.
 ```
 
 ## Addendum - more on installing command-line tools
@@ -559,7 +565,7 @@ so that they are accessible to all users. This works on both MacOS and Linux.
     # ln -s /usr/local/venv/bin/fixseqpadding /usr/local/bin/fixseqpadding
     # exit
     $ lsseq --version
-    4.3.0
+    4.3.1
 ```
 
 At this point any user should be able to run any of the commands linked in the example above.
@@ -631,7 +637,8 @@ the transition quite painless. Especially if you make use
 of [`runsed`](https://github.com/jrowellfx/vfxTdUtils) which if you haven't used it before,
 now is the time, it's extremely helpful.
 
-There are two files provided at the root-level of the repo, namely:
+There are two files provided at the root-level of the repo in
+the directory [`updateLongOpts`](https://github.com/jrowellfx/lsseq/tree/master/updateLongOpts), namely:
 `sed.script.jrowellfx.doubleDashToKebab` and `sed.script.lsseq.v3tov4`.
 
 The first one can be used to fix the long-option names for ALL the 
@@ -646,14 +653,13 @@ on your system.
 ```
 $ cd ~/bin
 $ ls
-myScriptThatUsesLsseq
+myScriptThatUsesLsseq  sed.script.jrowellfx.doubleDashToKebab
 $ cat myScriptThatUsesLsseq
 #!/bin/bash
 
 lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
 
-$ mv ~/Downloads/sed.script.jrowellfx.doubleDashToKebab sed.script
-$ runsed myScriptThatUsesLsseq
+$ runsed -f sed.script.jrowellfx.doubleDashToKebab myScriptThatUsesLsseq
 $ ./.runsed.diff.runsed
 + /usr/bin/diff ./.myScriptThatUsesLsseq.runsed myScriptThatUsesLsseq
 3c3

{lsseq-4.3.0 → lsseq-4.3.1}/README.md

@@ -65,6 +65,8 @@ however it can print sequences in a variety of formats useful for `nuke`,
 ```
     python3 -m pip install lsseq --upgrade
 ```
+If installing locally, it's probably best to install in a virtual-environment
+or [`venv`](https://docs.python.org/3/library/venv.html). 
 
 There is additional installation-information in an
 [addendum](https://github.com/jrowellfx/lsseq#addendum---more-on-installing-command-line-tools)
@@ -238,7 +240,7 @@ extend `lsseq's` capability.
     bbb/bbx.[0097-0103].tif
     bbb/bby.[0197-0203].tif
 
-    5$ lsseq --prepend-path-abs --skip-missing --format rv *
+    5$ lsseq --prepend-path-abs --format rv *
     /user/jrowellfx/test/ccc.0101.exr
     /user/jrowellfx/test/aaa/aaa.97-103@@@.tif
     /user/jrowellfx/test/bbb/bbx.97-103#.tif
@@ -289,12 +291,13 @@ the following EXIT codes will be combined bitwise to return
 possibly more than one different warning and/or error.
 
 ```
-EXIT_NO_ERROR               = 0 # Clean exit.
-EXIT_LS_ERROR               = 1 # A call to 'ls' returned an error code.
-EXIT_ARGPARSE_ERROR         = 2 # A bad option was passed to lsseq. Exit lsseq.
-EXIT_LSSEQ_SOFTLINK_WARNING = 4 # warning - broken softlink found
-EXIT_LSSEQ_PADDING_WARNING  = 8 # warning - two images with same name, same frame-num, but diff padding
-EXIT_CD_PERMISSION_WARNING  = 16 # warning - recursive descent blocked - no execute permission on dir
+EXIT_NO_ERROR                 =  0 # Clean exit.
+EXIT_LS_WARNING               =  1 # A call to 'ls' returned an error or another internal issue
+EXIT_ARGPARSE_ERROR           =  2 # The default code that argparse exits with if bad option.
+EXIT_LSSEQ_SOFTLINK_WARNING   =  4 # warning - broken softlink
+EXIT_LSSEQ_PADDING_WARNING    =  8 # warning - two images with same name, same frame-num, diff padding
+EXIT_CD_PERMISSION_WARNING    = 16 # warning - recursive descent blocked - no execute permission on dir
+EXIT_LSSEQ_NOSUCHFILE_WARNING = 32 # A non-existent sequence-file was listed on the command line.
 ```
 
 ## `lsseq --help`
@@ -501,7 +504,10 @@ LS(1) control for non-sequences:
   --directory, -d       list directory entries instead of contents, and do not
                         follow symbolic links (see LS(1))
   --classify, -F        append indicator (one of */=>@|) to entries, and do
-                        not follow symbolic links. (see LS(1))
+                        not follow symbolic links to directories. (see LS(1)
+                        for the meanings of the symbols.) Note: the '@' will
+                        also be appended to any sequences made up of symbolic
+                        links.
 ```
 
 ## Addendum - more on installing command-line tools
@@ -530,7 +536,7 @@ so that they are accessible to all users. This works on both MacOS and Linux.
     # ln -s /usr/local/venv/bin/fixseqpadding /usr/local/bin/fixseqpadding
     # exit
     $ lsseq --version
-    4.3.0
+    4.3.1
 ```
 
 At this point any user should be able to run any of the commands linked in the example above.
@@ -602,7 +608,8 @@ the transition quite painless. Especially if you make use
 of [`runsed`](https://github.com/jrowellfx/vfxTdUtils) which if you haven't used it before,
 now is the time, it's extremely helpful.
 
-There are two files provided at the root-level of the repo, namely:
+There are two files provided at the root-level of the repo in
+the directory [`updateLongOpts`](https://github.com/jrowellfx/lsseq/tree/master/updateLongOpts), namely:
 `sed.script.jrowellfx.doubleDashToKebab` and `sed.script.lsseq.v3tov4`.
 
 The first one can be used to fix the long-option names for ALL the 
@@ -617,14 +624,13 @@ on your system.
 ```
 $ cd ~/bin
 $ ls
-myScriptThatUsesLsseq
+myScriptThatUsesLsseq  sed.script.jrowellfx.doubleDashToKebab
 $ cat myScriptThatUsesLsseq
 #!/bin/bash
 
 lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
 
-$ mv ~/Downloads/sed.script.jrowellfx.doubleDashToKebab sed.script
-$ runsed myScriptThatUsesLsseq
+$ runsed -f sed.script.jrowellfx.doubleDashToKebab myScriptThatUsesLsseq
 $ ./.runsed.diff.runsed
 + /usr/bin/diff ./.myScriptThatUsesLsseq.runsed myScriptThatUsesLsseq
 3c3

{lsseq-4.3.0 → lsseq-4.3.1}/lsseq/__main__.py

@@ -69,7 +69,7 @@ import seqLister
 # MINOR version for added functionality in a backwards compatible manner
 # PATCH version for backwards compatible bug fixes
 #
-VERSION = "4.3.0"     # Semantic Versioning 2.0.0
+VERSION = "4.3.1"     # Semantic Versioning 2.0.0
 
 PROG_NAME = "lsseq"
 
@@ -351,7 +351,7 @@ def readByteShortForm(numBytes) :
         multiplier = 1<<30
         numBytes = numBytes[:-1]
 
-    try :
+    try:
         b = float(numBytes)
         if b <= 0 :
             return 512
@@ -1644,6 +1644,23 @@ def listSeqDir(dirContents, path, isCmdLineArg, args, traversedPath) :
             else :
                 passedPath = traversedPath + d + "/"
 
+            # JPR - first check if we have permission for directory 'd'.
+            #
+            can_read = os.access(d, os.Sanitize_Flags if hasattr(os, 'Sanitize_Flags') else os.R_OK)
+            can_execute = os.access(d, os.X_OK)  # Required to enter/traverse a directory
+            if not (can_read and can_execute) :
+                if not args.silent :
+                    sys.stdout.flush()
+                    sys.stderr.flush()
+                    if passedPath[-1] == "/" :
+                        passedPath = passedPath[:-1]
+                    print(PROG_NAME, ": warning: can not descend into ",
+                        passedPath, ": permission denied.",
+                        sep='', file=sys.stderr)
+                    sys.stderr.flush()
+                gExitStatus = gExitStatus | EXIT_CD_PERMISSION_WARNING
+                continue
+            #
             listSeqDir(stripDotFiles(os.listdir(d), args.ignoreDotFiles),
                 d, False, args, passedPath)
 

{lsseq-4.3.0 → lsseq-4.3.1}/lsseq.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lsseq
-Version: 4.3.0
+Version: 4.3.1
 Summary: ls-like command for image-sequences
 Home-page: https://github.com/jrowellfx/lsseq
 Author: James Philip Rowell
@@ -94,6 +94,8 @@ however it can print sequences in a variety of formats useful for `nuke`,
 ```
     python3 -m pip install lsseq --upgrade
 ```
+If installing locally, it's probably best to install in a virtual-environment
+or [`venv`](https://docs.python.org/3/library/venv.html). 
 
 There is additional installation-information in an
 [addendum](https://github.com/jrowellfx/lsseq#addendum---more-on-installing-command-line-tools)
@@ -267,7 +269,7 @@ extend `lsseq's` capability.
     bbb/bbx.[0097-0103].tif
     bbb/bby.[0197-0203].tif
 
-    5$ lsseq --prepend-path-abs --skip-missing --format rv *
+    5$ lsseq --prepend-path-abs --format rv *
     /user/jrowellfx/test/ccc.0101.exr
     /user/jrowellfx/test/aaa/aaa.97-103@@@.tif
     /user/jrowellfx/test/bbb/bbx.97-103#.tif
@@ -318,12 +320,13 @@ the following EXIT codes will be combined bitwise to return
 possibly more than one different warning and/or error.
 
 ```
-EXIT_NO_ERROR               = 0 # Clean exit.
-EXIT_LS_ERROR               = 1 # A call to 'ls' returned an error code.
-EXIT_ARGPARSE_ERROR         = 2 # A bad option was passed to lsseq. Exit lsseq.
-EXIT_LSSEQ_SOFTLINK_WARNING = 4 # warning - broken softlink found
-EXIT_LSSEQ_PADDING_WARNING  = 8 # warning - two images with same name, same frame-num, but diff padding
-EXIT_CD_PERMISSION_WARNING  = 16 # warning - recursive descent blocked - no execute permission on dir
+EXIT_NO_ERROR                 =  0 # Clean exit.
+EXIT_LS_WARNING               =  1 # A call to 'ls' returned an error or another internal issue
+EXIT_ARGPARSE_ERROR           =  2 # The default code that argparse exits with if bad option.
+EXIT_LSSEQ_SOFTLINK_WARNING   =  4 # warning - broken softlink
+EXIT_LSSEQ_PADDING_WARNING    =  8 # warning - two images with same name, same frame-num, diff padding
+EXIT_CD_PERMISSION_WARNING    = 16 # warning - recursive descent blocked - no execute permission on dir
+EXIT_LSSEQ_NOSUCHFILE_WARNING = 32 # A non-existent sequence-file was listed on the command line.
 ```
 
 ## `lsseq --help`
@@ -530,7 +533,10 @@ LS(1) control for non-sequences:
   --directory, -d       list directory entries instead of contents, and do not
                         follow symbolic links (see LS(1))
   --classify, -F        append indicator (one of */=>@|) to entries, and do
-                        not follow symbolic links. (see LS(1))
+                        not follow symbolic links to directories. (see LS(1)
+                        for the meanings of the symbols.) Note: the '@' will
+                        also be appended to any sequences made up of symbolic
+                        links.
 ```
 
 ## Addendum - more on installing command-line tools
@@ -559,7 +565,7 @@ so that they are accessible to all users. This works on both MacOS and Linux.
     # ln -s /usr/local/venv/bin/fixseqpadding /usr/local/bin/fixseqpadding
     # exit
     $ lsseq --version
-    4.3.0
+    4.3.1
 ```
 
 At this point any user should be able to run any of the commands linked in the example above.
@@ -631,7 +637,8 @@ the transition quite painless. Especially if you make use
 of [`runsed`](https://github.com/jrowellfx/vfxTdUtils) which if you haven't used it before,
 now is the time, it's extremely helpful.
 
-There are two files provided at the root-level of the repo, namely:
+There are two files provided at the root-level of the repo in
+the directory [`updateLongOpts`](https://github.com/jrowellfx/lsseq/tree/master/updateLongOpts), namely:
 `sed.script.jrowellfx.doubleDashToKebab` and `sed.script.lsseq.v3tov4`.
 
 The first one can be used to fix the long-option names for ALL the 
@@ -646,14 +653,13 @@ on your system.
 ```
 $ cd ~/bin
 $ ls
-myScriptThatUsesLsseq
+myScriptThatUsesLsseq  sed.script.jrowellfx.doubleDashToKebab
 $ cat myScriptThatUsesLsseq
 #!/bin/bash
 
 lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
 
-$ mv ~/Downloads/sed.script.jrowellfx.doubleDashToKebab sed.script
-$ runsed myScriptThatUsesLsseq
+$ runsed -f sed.script.jrowellfx.doubleDashToKebab myScriptThatUsesLsseq
 $ ./.runsed.diff.runsed
 + /usr/bin/diff ./.myScriptThatUsesLsseq.runsed myScriptThatUsesLsseq
 3c3

{lsseq-4.3.0 → lsseq-4.3.1}/setup.py

@@ -8,7 +8,7 @@ long_description = (here / 'README.md').read_text(encoding='utf-8')
 
 setup(
     name            = 'lsseq',
-    version         = '4.3.0',
+    version         = '4.3.1',
     description='ls-like command for image-sequences',
     long_description=long_description,
     long_description_content_type='text/markdown',