expandSeq 2.3.0__tar.gz → 4.0.0__tar.gz

{expandSeq-2.3.0 → expandseq-4.0.0}/LICENSE

@@ -1,6 +1,6 @@
 3-Clause BSD License
 
-Copyright (c) 2008-2021, James Philip Rowell,
+Copyright (c) 2008-2025, James Philip Rowell,
 Alpha Eleven Incorporated
 www.alpha-eleven.com
 All rights reserved.

expandseq-4.0.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.2
+Name: expandSeq
+Version: 4.0.0
+Summary: Command line utils to expose functionality of seqLister python library.
+Home-page: https://github.com/jrowellfx/expandSeq
+Author: James Philip Rowell
+Author-email: james@alpha-eleven.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.6, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: seqLister>=1.1.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# About expandseq and consdenseseq
+
+`expandseq` and `condenseseq` are two unix/linux command-line utilitiies 
+for expanding and condensing
+integer-sequences using a simple syntax widely used within
+the VFX-industry for specifying frame-ranges.
+
+## Definition: 'Frame-Range'.
+
+Given that 'A', 'B' and 'N' are integers, the syntax
+for specifying an integer sequence used to describe
+frame-ranges is one of the following three cases:
+
+1. 'A' : just the integer A.
+
+2. 'A-B' : all the integers from A to B inclusive.
+
+3. 'A-BxN' : every Nth integer starting at A and increasing
+to be no larger than B when A < B, or descending
+to be no less than B when A > B.
+
+The above three cases may be combined to describe
+less regular lists of Frame-Ranges by concatenating one
+Frame-Range after another separated by spaces or commas.
+
+## Installing the commands
+
+```
+python3 -m pip install expandSeq --upgrade
+```
+
+## Testing the installation
+
+You should be able to run the following commands and get this output.
+
+```
+1$ expandseq 1-10
+1 2 3 4 5 6 7 8 9 10
+2$ condenseseq 1 2 3 4 5 7 9 11 13 15
+1-4 5-15x2
+```
+
+## expandseq
+
+```
+expandseq [OPTION]... [FRAME-RANGE]...
+
+Expands a list of FRAME-RANGEs into a list of integers.
+
+Example:
+    $ expandseq 2-4 1-6 10
+    2 3 4 1 5 6 10
+
+Note in the above example that numbers are only listed once each.
+That is, once '2-4' is listed, then '1-6' only need list 1, 5 and 6.
+
+More examples:
+    $ expandseq 1-10x2, 20-60x10
+    1 3 5 7 9 20 30 40 50 60
+    $ expandseq --pad 3 109-91x4
+    109 105 101 097 093
+    $ expandseq --pad 4 -- -99-86x23
+    -099 -076 -053 -030 -007 0016 0039 0062 0085
+
+Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+as a command-line OPTION insert a double-minus ('--') before the
+negative-number, which is a standard technique to deliniate the end
+of command-line options.
+
+positional arguments:
+  FRAME-RANGE           See the definition of 'FRAME-RANGE' above.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --delimiter DELIMITER, -d DELIMITER
+                        List successive numbers delimited by a 'comma',
+                        'space' (default) or a 'newline'.
+  --pad PAD             set the padding of the frame numbers to be <PAD>
+                        digits. [default: 1]
+  --reverse, -r         reverse the order of the list
+  --sort, -s            sort the resulting list
+  --error               exit with error if FRAME-RANGE is invalid. (default)
+  --no-error             skip invalid FRAME-RANGEs, but print warning
+  --silent, --quiet     suppress all errors and warnings
+```
+
+## condenseseq
+
+```
+condenseseq [OPTION]... [FRAME-RANGE]...
+
+Given a list of FRAME-RANGEs condense the fully expanded list into
+the most succinct list of FRAME-RANGEs possible.
+
+Examples:
+    $ condenseseq 1-100x2 2-100x2
+    1-100
+    $ condenseseq 0-100x2 51
+    0-50x2 51 52-100x2
+    $ condenseseq --pad 3 49 0-100x2 51 53
+    000-048x2 049-053 054-100x2
+
+Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+as a command-line OPTION insert a double-minus ('--') before the
+negative-number, which is a standard technique to deliniate the end
+of command-line options.
+
+positional arguments:
+  FRAME-RANGE           See the definition of 'FRAME-RANGE' above.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --delimiter DELIMITER, -d DELIMITER
+                        List successive numbers delimited by a 'comma',
+                        'space' (default) or a 'newline'.
+  --only-ones            only condense sucessive frames, that is, do not list
+                        sequences on 2's, 3's, ... N's
+  --pad PAD             set the padding of the frame numbers to be <PAD>
+                        digits. [default: 1]
+  --error               exit with error if FRAME-RANGE is invalid. (default)
+  --no-error             skip invalid FRAME-RANGEs, but print warning
+  --silent, --quiet     suppress all errors and warnings
+
+```

expandseq-4.0.0/README.md

@@ -0,0 +1,126 @@
+# About expandseq and consdenseseq
+
+`expandseq` and `condenseseq` are two unix/linux command-line utilitiies 
+for expanding and condensing
+integer-sequences using a simple syntax widely used within
+the VFX-industry for specifying frame-ranges.
+
+## Definition: 'Frame-Range'.
+
+Given that 'A', 'B' and 'N' are integers, the syntax
+for specifying an integer sequence used to describe
+frame-ranges is one of the following three cases:
+
+1. 'A' : just the integer A.
+
+2. 'A-B' : all the integers from A to B inclusive.
+
+3. 'A-BxN' : every Nth integer starting at A and increasing
+to be no larger than B when A < B, or descending
+to be no less than B when A > B.
+
+The above three cases may be combined to describe
+less regular lists of Frame-Ranges by concatenating one
+Frame-Range after another separated by spaces or commas.
+
+## Installing the commands
+
+```
+python3 -m pip install expandSeq --upgrade
+```
+
+## Testing the installation
+
+You should be able to run the following commands and get this output.
+
+```
+1$ expandseq 1-10
+1 2 3 4 5 6 7 8 9 10
+2$ condenseseq 1 2 3 4 5 7 9 11 13 15
+1-4 5-15x2
+```
+
+## expandseq
+
+```
+expandseq [OPTION]... [FRAME-RANGE]...
+
+Expands a list of FRAME-RANGEs into a list of integers.
+
+Example:
+    $ expandseq 2-4 1-6 10
+    2 3 4 1 5 6 10
+
+Note in the above example that numbers are only listed once each.
+That is, once '2-4' is listed, then '1-6' only need list 1, 5 and 6.
+
+More examples:
+    $ expandseq 1-10x2, 20-60x10
+    1 3 5 7 9 20 30 40 50 60
+    $ expandseq --pad 3 109-91x4
+    109 105 101 097 093
+    $ expandseq --pad 4 -- -99-86x23
+    -099 -076 -053 -030 -007 0016 0039 0062 0085
+
+Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+as a command-line OPTION insert a double-minus ('--') before the
+negative-number, which is a standard technique to deliniate the end
+of command-line options.
+
+positional arguments:
+  FRAME-RANGE           See the definition of 'FRAME-RANGE' above.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --delimiter DELIMITER, -d DELIMITER
+                        List successive numbers delimited by a 'comma',
+                        'space' (default) or a 'newline'.
+  --pad PAD             set the padding of the frame numbers to be <PAD>
+                        digits. [default: 1]
+  --reverse, -r         reverse the order of the list
+  --sort, -s            sort the resulting list
+  --error               exit with error if FRAME-RANGE is invalid. (default)
+  --no-error             skip invalid FRAME-RANGEs, but print warning
+  --silent, --quiet     suppress all errors and warnings
+```
+
+## condenseseq
+
+```
+condenseseq [OPTION]... [FRAME-RANGE]...
+
+Given a list of FRAME-RANGEs condense the fully expanded list into
+the most succinct list of FRAME-RANGEs possible.
+
+Examples:
+    $ condenseseq 1-100x2 2-100x2
+    1-100
+    $ condenseseq 0-100x2 51
+    0-50x2 51 52-100x2
+    $ condenseseq --pad 3 49 0-100x2 51 53
+    000-048x2 049-053 054-100x2
+
+Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+as a command-line OPTION insert a double-minus ('--') before the
+negative-number, which is a standard technique to deliniate the end
+of command-line options.
+
+positional arguments:
+  FRAME-RANGE           See the definition of 'FRAME-RANGE' above.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --delimiter DELIMITER, -d DELIMITER
+                        List successive numbers delimited by a 'comma',
+                        'space' (default) or a 'newline'.
+  --only-ones            only condense sucessive frames, that is, do not list
+                        sequences on 2's, 3's, ... N's
+  --pad PAD             set the padding of the frame numbers to be <PAD>
+                        digits. [default: 1]
+  --error               exit with error if FRAME-RANGE is invalid. (default)
+  --no-error             skip invalid FRAME-RANGEs, but print warning
+  --silent, --quiet     suppress all errors and warnings
+
+```

expandseq-4.0.0/condenseseq/__main__.py

@@ -0,0 +1,240 @@
+#!/usr/bin/env python3
+
+# 3-Clause BSD License
+# 
+# Copyright (c) 2008-2025, James Philip Rowell,
+# Alpha Eleven Incorporated
+# www.alpha-eleven.com
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+# 
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+# 
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in
+#     the documentation and/or other materials provided with the
+#     distribution.
+# 
+#  3. Neither the name of the copyright holder, "Alpha Eleven, Inc.",
+#     nor the names of its contributors may be used to endorse or
+#     promote products derived from this software without specific prior
+#     written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# expandseq/condenseseq - two command line utilities that expose and
+# expand upon the basic functionality of the python-module "seqLister"
+# functions "expandSeq()" and "condenseSeq()".
+
+import argparse
+import os
+import sys
+import subprocess
+import textwrap
+from operator import itemgetter
+import seqLister
+
+# MAJOR version for incompatible API changes
+# MINOR version for added functionality in a backwards compatible manner
+# PATCH version for backwards compatible bug fixes
+#
+VERSION     = "4.0.0"
+
+PROG_NAME = "condenseseq"
+
+def main():
+
+    # Redefine the exception handling routine so that it does NOT
+    # do a trace dump if the user types ^C while expandseq or
+    # condenseseq are running.
+    #
+    old_excepthook = sys.excepthook
+    def new_hook(exceptionType, value, traceback):
+        if exceptionType != KeyboardInterrupt and exceptionType != IOError:
+            old_excepthook(exceptionType, value, traceback)
+        else:
+            pass
+    sys.excepthook = new_hook
+
+    p = argparse.ArgumentParser(
+
+    formatter_class=argparse.RawDescriptionHelpFormatter,
+        prog=PROG_NAME,
+        description=textwrap.dedent('''\
+            Given a list of FRAME-RANGEs condense the fully expanded list into
+            the most succinct list of FRAME-RANGEs possible.
+
+            Definition: FRAME-RANGE
+                Given that 'A', 'B' and 'N' are integers, then a FRAME-RANGE is one,
+                or any combination, of the following:
+
+                   'A'     the integer A.
+
+                   'A-B'   all the integers from A to B inclusive.
+
+                   'A-BxN' every Nth integer starting at A and increasing to be no
+                           larger than B when A < B, or decreasing to be no less
+                           than B when A > B.
+
+            FRAME-RANGEs may be combined to describe less regular sequences by
+            concatenating one after another separated by spaces or commas.
+
+            Examples:
+                $ condenseseq 1-100x2 2-100x2
+                1-100
+                $ condenseseq 0-100x2 51
+                0-50x2 51 52-100x2
+                $ condenseseq --pad 3 49 0-100x2 51 53
+                000-048x2 049-053 054-100x2
+
+            Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+            as a command-line OPTION insert a double-minus ('--') before the
+            negative-number, which is a standard technique to deliniate the end
+            of command-line options.
+
+            (Also see expandseq).
+            '''),
+        usage="%(prog)s [OPTION]... [FRAME-RANGE]...")
+
+    p.add_argument("--version", action="version", version=VERSION)
+    p.add_argument("--delimiter", "-d", action="store", type=str,
+        choices=("comma", "space", "newline"),
+        dest="seqDelimiter",
+        metavar="DELIMITER",
+        default="space",
+        help="List successive numbers delimited by a 'comma', 'space' (default) or a 'newline'.")
+    p.add_argument("--only-ones", action="store_true",
+        dest="onlyOnes", default=False,
+        help="only condense sucessive frames, that is, do not list sequences on 2's, 3's, ... N's")
+    p.add_argument("--pad", action="store", type=int,
+       dest="pad", default=1,
+       metavar="PAD",
+       help="set the padding of the frame numbers to be <PAD> digits. [default: 1]")
+
+    p.add_argument("--error", action="store_true",
+        dest="exitOnError", default=True,
+        help="exit with error if FRAME-RANGE is invalid. (default)" )
+    p.add_argument("--no-error", action="store_false",
+        dest="exitOnError",
+        help="skip invalid FRAME-RANGEs, but print warning" )
+
+    p.add_argument("--silent", "--quiet", action="store_true",
+        dest="silent", default=False,
+        help="suppress all errors and warnings")
+
+    p.add_argument("numSequences", metavar="FRAME-RANGE", nargs="*",
+        help="See the definition of 'FRAME-RANGE' above.")
+
+    args = p.parse_args()
+
+    # Copy the command line args converting commas into spaces and then 
+    # splitting along ALL whitespace possibly generating more args.
+    #
+    separateArgs = []
+    for a in args.numSequences :
+        for b in a.split(',') :
+            for c in b.split() :
+                separateArgs.append(c)
+    remainingArgs = []
+
+    # Now fully expand all the FRAME-RANGES supplied to get a FULL set of frame
+    # numbers before condensing the full list.
+    #
+    expandedArgs = seqLister.expandSeq(separateArgs, remainingArgs)
+
+    # Any non-FRAME-RANGES, should have been caught at this point, so we can
+    # process the possible errors and warnings now. Same code as expandSeq command.
+    #
+    # Check for any invalid FRAME-RANGEs, and respond according to
+    # flags set with OPTIONS. Only show up to 3 bad FRAME-RANGES,
+    # chop any after that and append an 'etc.' note to the warning
+    # or error message.
+    #
+    badArgsLength = len(remainingArgs)
+    if badArgsLength > 0 :
+
+        badArgsEtcLength = badArgsLength
+        if badArgsLength > 3 :
+            badArgsEtcLength = 3
+
+        plural = ''
+        count = ''
+        if badArgsLength > 1 :
+            plural = 's'
+            count = str(badArgsLength) + ' '
+
+        badFramesMessage = count \
+            + 'invalid FRAME-RANGE' \
+            + plural + ': ' \
+            + ', '.join(remainingArgs[:badArgsEtcLength])
+
+        if badArgsLength > 3 :
+            badFramesMessage += ', ... etc.'
+
+        if args.exitOnError :
+            if not args.silent :
+                print(PROG_NAME,
+                    ": error: ", badFramesMessage,
+                    file=sys.stderr, sep='')
+            sys.exit(1)
+        else :
+            if not args.silent :
+                print(PROG_NAME,
+                    ": warning: ", badFramesMessage,
+                    file=sys.stderr, sep='')
+
+    tmpList = []
+    if args.onlyOnes :
+        result = seqLister.condenseSeqOnes(expandedArgs, args.pad, tmpList)
+
+        # tmpList should be zero length since expandSeq() call above should
+        # have caught all the issues with badly formed FRAME-RANGEs.
+        #
+        if len(tmpList) > 0 and not args.silent :
+            print(PROG_NAME,
+                ": ASSERT FAILURE: call to seqLister.condenseSeqOnes() returned non-zero length nonSeqList.",
+                file=sys.stderr, sep='')
+    else :
+        result = seqLister.condenseSeq(expandedArgs, args.pad, tmpList)
+
+        # tmpList should be zero length since expandSeq() call above should
+        # have caught all the issues with badly formed FRAME-RANGEs.
+        #
+        if len(tmpList) > 0 and not args.silent :
+            print(PROG_NAME,
+                ": ASSERT FAILURE: call to seqLister.condenseSeq() returned non-zero length nonSeqList.",
+                file=sys.stderr, sep='')
+
+    isFirst = True
+    for s in result :
+        if args.seqDelimiter == 'space' :
+            if not isFirst :
+                sys.stdout.write(' ')
+            sys.stdout.write(str(s))
+            isFirst = False
+        elif args.seqDelimiter == 'comma' :
+            if not isFirst :
+                sys.stdout.write(',')
+            sys.stdout.write(str(s))
+            isFirst = False
+        else : # newline
+            print(s)
+    if (args.seqDelimiter == 'comma' or args.seqDelimiter == 'space') and not isFirst :
+        print()
+
+if __name__ == '__main__':
+    main()

expandseq-4.0.0/expandSeq.egg-info/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.2
+Name: expandSeq
+Version: 4.0.0
+Summary: Command line utils to expose functionality of seqLister python library.
+Home-page: https://github.com/jrowellfx/expandSeq
+Author: James Philip Rowell
+Author-email: james@alpha-eleven.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.6, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: seqLister>=1.1.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# About expandseq and consdenseseq
+
+`expandseq` and `condenseseq` are two unix/linux command-line utilitiies 
+for expanding and condensing
+integer-sequences using a simple syntax widely used within
+the VFX-industry for specifying frame-ranges.
+
+## Definition: 'Frame-Range'.
+
+Given that 'A', 'B' and 'N' are integers, the syntax
+for specifying an integer sequence used to describe
+frame-ranges is one of the following three cases:
+
+1. 'A' : just the integer A.
+
+2. 'A-B' : all the integers from A to B inclusive.
+
+3. 'A-BxN' : every Nth integer starting at A and increasing
+to be no larger than B when A < B, or descending
+to be no less than B when A > B.
+
+The above three cases may be combined to describe
+less regular lists of Frame-Ranges by concatenating one
+Frame-Range after another separated by spaces or commas.
+
+## Installing the commands
+
+```
+python3 -m pip install expandSeq --upgrade
+```
+
+## Testing the installation
+
+You should be able to run the following commands and get this output.
+
+```
+1$ expandseq 1-10
+1 2 3 4 5 6 7 8 9 10
+2$ condenseseq 1 2 3 4 5 7 9 11 13 15
+1-4 5-15x2
+```
+
+## expandseq
+
+```
+expandseq [OPTION]... [FRAME-RANGE]...
+
+Expands a list of FRAME-RANGEs into a list of integers.
+
+Example:
+    $ expandseq 2-4 1-6 10
+    2 3 4 1 5 6 10
+
+Note in the above example that numbers are only listed once each.
+That is, once '2-4' is listed, then '1-6' only need list 1, 5 and 6.
+
+More examples:
+    $ expandseq 1-10x2, 20-60x10
+    1 3 5 7 9 20 30 40 50 60
+    $ expandseq --pad 3 109-91x4
+    109 105 101 097 093
+    $ expandseq --pad 4 -- -99-86x23
+    -099 -076 -053 -030 -007 0016 0039 0062 0085
+
+Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+as a command-line OPTION insert a double-minus ('--') before the
+negative-number, which is a standard technique to deliniate the end
+of command-line options.
+
+positional arguments:
+  FRAME-RANGE           See the definition of 'FRAME-RANGE' above.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --delimiter DELIMITER, -d DELIMITER
+                        List successive numbers delimited by a 'comma',
+                        'space' (default) or a 'newline'.
+  --pad PAD             set the padding of the frame numbers to be <PAD>
+                        digits. [default: 1]
+  --reverse, -r         reverse the order of the list
+  --sort, -s            sort the resulting list
+  --error               exit with error if FRAME-RANGE is invalid. (default)
+  --no-error             skip invalid FRAME-RANGEs, but print warning
+  --silent, --quiet     suppress all errors and warnings
+```
+
+## condenseseq
+
+```
+condenseseq [OPTION]... [FRAME-RANGE]...
+
+Given a list of FRAME-RANGEs condense the fully expanded list into
+the most succinct list of FRAME-RANGEs possible.
+
+Examples:
+    $ condenseseq 1-100x2 2-100x2
+    1-100
+    $ condenseseq 0-100x2 51
+    0-50x2 51 52-100x2
+    $ condenseseq --pad 3 49 0-100x2 51 53
+    000-048x2 049-053 054-100x2
+
+Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+as a command-line OPTION insert a double-minus ('--') before the
+negative-number, which is a standard technique to deliniate the end
+of command-line options.
+
+positional arguments:
+  FRAME-RANGE           See the definition of 'FRAME-RANGE' above.
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --delimiter DELIMITER, -d DELIMITER
+                        List successive numbers delimited by a 'comma',
+                        'space' (default) or a 'newline'.
+  --only-ones            only condense sucessive frames, that is, do not list
+                        sequences on 2's, 3's, ... N's
+  --pad PAD             set the padding of the frame numbers to be <PAD>
+                        digits. [default: 1]
+  --error               exit with error if FRAME-RANGE is invalid. (default)
+  --no-error             skip invalid FRAME-RANGEs, but print warning
+  --silent, --quiet     suppress all errors and warnings
+
+```

{expandSeq-2.3.0 → expandseq-4.0.0}/expandSeq.egg-info/SOURCES.txt

@@ -2,6 +2,8 @@ LICENSE
 README.md
 setup.cfg
 setup.py
+condenseseq/__init__.py
+condenseseq/__main__.py
 expandSeq.egg-info/PKG-INFO
 expandSeq.egg-info/SOURCES.txt
 expandSeq.egg-info/dependency_links.txt

{expandSeq-2.3.0 → expandseq-4.0.0}/expandSeq.egg-info/entry_points.txt

@@ -1,4 +1,3 @@
 [console_scripts]
-condenseseq = expandseq.__main__:main
+condenseseq = condenseseq.__main__:main
 expandseq = expandseq.__main__:main
-

expandseq-4.0.0/expandSeq.egg-info/requires.txt

@@ -0,0 +1 @@
+seqLister>=1.1.0

expandseq-4.0.0/expandSeq.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+condenseseq
+expandseq

expandseq-4.0.0/expandseq/__main__.py

@@ -0,0 +1,235 @@
+#!/usr/bin/env python3
+
+# 3-Clause BSD License
+# 
+# Copyright (c) 2008-2025, James Philip Rowell,
+# Alpha Eleven Incorporated
+# www.alpha-eleven.com
+# All rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+# 
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+# 
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in
+#     the documentation and/or other materials provided with the
+#     distribution.
+# 
+#  3. Neither the name of the copyright holder, "Alpha Eleven, Inc.",
+#     nor the names of its contributors may be used to endorse or
+#     promote products derived from this software without specific prior
+#     written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# expandseq/condenseseq - two command line utilities that expose and
+# expand upon the basic functionality of the python-module "seqLister"
+# functions "expandSeq()" and "condenseSeq()".
+
+import argparse
+import os
+import sys
+import subprocess
+import textwrap
+from operator import itemgetter
+import seqLister
+
+# MAJOR version for incompatible API changes
+# MINOR version for added functionality in a backwards compatible manner
+# PATCH version for backwards compatible bug fixes
+#
+VERSION     = "4.0.0"
+
+PROG_NAME = "expandseq"
+
+def main():
+
+    # Redefine the exception handling routine so that it does NOT
+    # do a trace dump if the user types ^C while expandseq or
+    # condenseseq are running.
+    #
+    old_excepthook = sys.excepthook
+    def new_hook(exceptionType, value, traceback):
+        if exceptionType != KeyboardInterrupt and exceptionType != IOError:
+            old_excepthook(exceptionType, value, traceback)
+        else:
+            pass
+    sys.excepthook = new_hook
+
+    p = argparse.ArgumentParser(
+        prog=PROG_NAME,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        description=textwrap.dedent('''\
+            Expands a list of FRAME-RANGEs into a list of integers.  A FRAME-RANGE
+            is a simple syntax widely used within the VFX-industry for specifying a
+            list of frame-numbers for image-sequences.
+
+            Definition: FRAME-RANGE
+                Given that 'A', 'B' and 'N' are integers, then a FRAME-RANGE is one,
+                or any combination, of the following:
+
+                   'A'     the integer A.
+
+                   'A-B'   all the integers from A to B inclusive.
+
+                   'A-BxN' every Nth integer starting at A and increasing to be no
+                           larger than B when A < B, or decreasing to be no less
+                           than B when A > B.
+
+            FRAME-RANGEs may be combined to describe less regular sequences by
+            concatenating one after another separated by spaces or commas.
+
+            Example:
+                $ expandseq 2-4 1-6 10
+                2 3 4 1 5 6 10
+
+            Note in the above example that numbers are only listed once each.
+            That is, once '2-4' is listed, then '1-6' only need list 1, 5 and 6.
+
+            More examples:
+                $ expandseq 1-10x2, 20-60x10
+                1 3 5 7 9 20 30 40 50 60
+                $ expandseq --pad 3 109-91x4
+                109 105 101 097 093
+                $ expandseq --pad 4 -- -99-86x23
+                -099 -076 -053 -030 -007 0016 0039 0062 0085
+
+            Protip: To pass a negative-number to expandseq WITHOUT it being intepreted
+            as a command-line OPTION insert a double-minus ('--') before the
+            negative-number, which is a standard technique to deliniate the end
+            of command-line options.
+
+            (Also see condenseseq).
+            '''),
+        usage="%(prog)s [OPTION]... [FRAME-RANGE]...")
+
+    p.add_argument("--version", action="version", version=VERSION)
+    p.add_argument("--delimiter", "-d", action="store", type=str,
+        choices=("comma", "space", "newline"),
+        dest="seqDelimiter",
+        metavar="DELIMITER",
+        default="space",
+        help="List successive numbers delimited by a 'comma',\
+            'space' (default) or a 'newline'.")
+    p.add_argument("--pad", action="store", type=int,
+       dest="pad", default=1, metavar="PAD",
+       help="set the padding of the frame numbers to be <PAD> digits. [default: 1]")
+    p.add_argument("--reverse", "-r", action="store_true",
+        dest="reverseList", default=False,
+        help="reverse the order of the list")
+    p.add_argument("--sort", "-s", action="store_true",
+        dest="sortList", default=False,
+        help="sort the resulting list")
+
+    p.add_argument("--error", action="store_true",
+        dest="exitOnError", default=True,
+        help="exit with error if FRAME-RANGE is invalid. (default)" )
+    p.add_argument("--no-error", action="store_false",
+        dest="exitOnError",
+        help="skip invalid FRAME-RANGEs, but print warning" )
+
+    p.add_argument("--silent", "--quiet", action="store_true",
+        dest="silent", default=False,
+        help="suppress all errors and warnings")
+
+    p.add_argument("numSequences", metavar="FRAME-RANGE", nargs="*",
+        help="See the definition of 'FRAME-RANGE' above.")
+
+    args = p.parse_args()
+
+    # Copy the command line args converting commas into spaces and then
+    # splitting along ALL whitespace possibly generating more args.
+    #
+    separateArgs = []
+    for a in args.numSequences :
+        for b in a.split(',') :
+            for c in b.split() :
+                separateArgs.append(c)
+    remainingArgs = []
+    result = seqLister.expandSeq(separateArgs, remainingArgs)
+
+    # Check for any invalid FRAME-RANGEs, and respond according to
+    # flags set with OPTIONS. Only show up to 3 bad FRAME-RANGES,
+    # chop any after that and append an 'etc.' note to the warning
+    # or error message.
+    #
+    badArgsLength = len(remainingArgs)
+    if badArgsLength > 0 :
+
+        badArgsEtcLength = badArgsLength
+        if badArgsLength > 3 :
+            badArgsEtcLength = 3
+
+        plural = ''
+        count = ''
+        if badArgsLength > 1 :
+            plural = 's'
+            count = str(badArgsLength) + ' '
+
+        badFramesMessage = count \
+            + 'invalid FRAME-RANGE' \
+            + plural + ': ' \
+            + ', '.join(remainingArgs[:badArgsEtcLength])
+
+        if badArgsLength > 3 :
+            badFramesMessage += ', ... etc.'
+
+        if args.exitOnError :
+            if not args.silent :
+                print(PROG_NAME,
+                    ": error: ", badFramesMessage,
+                    file=sys.stderr, sep='')
+            sys.exit(1)
+        else :
+            if not args.silent :
+                print(PROG_NAME,
+                    ": warning: ", badFramesMessage,
+                    file=sys.stderr, sep='')
+
+    if args.sortList :
+        result.sort()
+
+    # Pad list of integers and turn them into strings before printing.
+    #
+    formatStr = "{0:0=-" + str(args.pad) + "d}"
+    paddedFrames = []
+    for frame in result:
+        paddedFrames.append(formatStr.format(frame))
+    result = paddedFrames
+
+    if args.reverseList :
+        result.reverse()
+
+    isFirst = True
+    for s in result :
+        if args.seqDelimiter == 'space' :
+            if not isFirst :
+                sys.stdout.write(' ')
+            sys.stdout.write(str(s))
+            isFirst = False
+        elif args.seqDelimiter == 'comma' :
+            if not isFirst :
+                sys.stdout.write(',')
+            sys.stdout.write(str(s))
+            isFirst = False
+        else : # newline
+            print(s)
+    if (args.seqDelimiter == 'comma' or args.seqDelimiter == 'space') and not isFirst :
+        print()
+
+if __name__ == '__main__':
+    main()

{expandSeq-2.3.0 → expandseq-4.0.0}/setup.py

@@ -8,7 +8,7 @@ long_description = (here / 'README.md').read_text(encoding='utf-8')
 
 setup(
     name            = 'expandSeq',
-    version         = '2.3.0',
+    version         = '4.0.0',
     description='Command line utils to expose functionality of seqLister python library.',
     long_description=long_description,
     long_description_content_type='text/markdown',
@@ -25,14 +25,14 @@ setup(
         'Development Status :: 5 - Production/Stable',
     ],
 
-    packages        = ['expandseq'],
+    packages        = ['expandseq', 'condenseseq'],
     python_requires = '>=3.6, <4',
-    install_requires=['seqLister'],
+    install_requires=['seqLister>=1.1.0'],
 
     entry_points = {
         'console_scripts': [
             'expandseq = expandseq.__main__:main',
-            'condenseseq = expandseq.__main__:main'
+            'condenseseq = condenseseq.__main__:main'
         ]
     }
 )

expandSeq-2.3.0/PKG-INFO

@@ -1,26 +0,0 @@
-Metadata-Version: 2.1
-Name: expandSeq
-Version: 2.3.0
-Summary: Command line utils to expose functionality of seqLister python library.
-Home-page: https://github.com/jrowellfx/expandSeq
-Author: James Philip Rowell
-Author-email: james@alpha-eleven.com
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: POSIX
-Classifier: Operating System :: Unix
-Classifier: Operating System :: MacOS
-Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.6, <4
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# About expandseq and consdenseseq
-
-`expandseq` and `condenseseq`are two unix/linux command-line utilitiies that
-expose the functionality of the python library package `seqLister` to shell users.
-
-
-

expandSeq-2.3.0/README.md

@@ -1,5 +0,0 @@
-# About expandseq and consdenseseq
-
-`expandseq` and `condenseseq`are two unix/linux command-line utilitiies that
-expose the functionality of the python library package `seqLister` to shell users.
-

expandSeq-2.3.0/expandSeq.egg-info/PKG-INFO

@@ -1,26 +0,0 @@
-Metadata-Version: 2.1
-Name: expandSeq
-Version: 2.3.0
-Summary: Command line utils to expose functionality of seqLister python library.
-Home-page: https://github.com/jrowellfx/expandSeq
-Author: James Philip Rowell
-Author-email: james@alpha-eleven.com
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: POSIX
-Classifier: Operating System :: Unix
-Classifier: Operating System :: MacOS
-Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.6, <4
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
-# About expandseq and consdenseseq
-
-`expandseq` and `condenseseq`are two unix/linux command-line utilitiies that
-expose the functionality of the python library package `seqLister` to shell users.
-
-
-

expandSeq-2.3.0/expandSeq.egg-info/requires.txt

@@ -1 +0,0 @@
-seqLister

expandSeq-2.3.0/expandSeq.egg-info/top_level.txt

@@ -1 +0,0 @@
-expandseq

expandSeq-2.3.0/expandseq/__main__.py

@@ -1,219 +0,0 @@
-# 3-Clause BSD License
-# 
-# Copyright (c) 2008-2021, James Philip Rowell,
-# Alpha Eleven Incorporated
-# www.alpha-eleven.com
-# All rights reserved.
-# 
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are
-# met:
-# 
-#  1. Redistributions of source code must retain the above copyright
-#     notice, this list of conditions and the following disclaimer.
-# 
-#  2. Redistributions in binary form must reproduce the above copyright
-#     notice, this list of conditions and the following disclaimer in
-#     the documentation and/or other materials provided with the
-#     distribution.
-# 
-#  3. Neither the name of the copyright holder, "Alpha Eleven, Inc.",
-#     nor the names of its contributors may be used to endorse or
-#     promote products derived from this software without specific prior
-#     written permission.
-# 
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-# A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
-# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-# expandseq/condenseseq - two command line utilities that expose the basic
-# functionality of the python-module "seqLister.py" functions "expandSeq()"
-# and "condenseSeq()".  These functions translate back and forth between a
-# condensed form for listing sequences of integers and plain lists of integers.
-# Lists of integers in this condensed format are commonly used by various
-# computer programs dealing with sequences of images such as render farm
-# management tools (like smedge), image sequence viewers (like rv) or "ls"
-# commands (like lsseq) to list frames from CG-animation or video footage
-# which has been saved as a sequence of individually numbered frames.
-#
-# The "expandseq" and "condenseseq" commands enhance the simple behavior of
-# the "expandSeq()" and "condenseSeq()" python functions by adding the ability
-# to print out the lists in various forms.  eg.; comma, space or newline
-# separators as well as sorting the lists, reversing order, and mixing and
-# matching expanded and condensed formats as arguments on the command line.
-
-import argparse
-import os
-import sys
-import subprocess
-import textwrap
-from operator import itemgetter
-import seqLister
-
-EXPAND_MODE = True
-VERSION     = "2.3.0"
-
-def indexNegNumber(argList) :
-    i = 0
-    argLen = len(argList)
-    while i < argLen :
-        if len(argList[i]) >= 2 :
-            if argList[i][0] == '-' and argList[i][1].isdigit() :
-                return i
-        i += 1
-    return -1
-
-def main():
-
-    # Redefine the exception handling routine so that it does NOT
-    # do a trace dump if the user types ^C while expandseq or
-    # condenseseq are running.
-    #
-    old_excepthook = sys.excepthook
-    def new_hook(exceptionType, value, traceback):
-        if exceptionType != KeyboardInterrupt and exceptionType != IOError:
-            old_excepthook(exceptionType, value, traceback)
-        else:
-            pass
-    sys.excepthook = new_hook
-
-    global EXPAND_MODE
-    if os.path.basename(sys.argv[0]) == "expandseq" :
-        EXPAND_MODE = True
-    elif os.path.basename(sys.argv[0]) == "condenseseq" :
-        EXPAND_MODE = False
-    else :
-        print(os.path.basename(sys.argv[0]), ": must be named either expandseq or condenseseq", sep='', file=sys.stderr)
-        sys.exit(1)
-
-    if EXPAND_MODE :
-        p = argparse.ArgumentParser(
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        description=textwrap.dedent('''\
-            Expands a list of integers and integer sequences of the form 'A-B' or
-            'A-BxN' into a list of integers.
-
-            A-BxN means list every Nth integer starting at A ending at the highest
-            integer less than or equal to B. Numbers will only be listed once
-            each.  That is; '2-4 1-6' yeilds the list '2 3 4 1 5 6'.
-
-                Helpful hint: To pass negative numbers as an argument enclose them
-                with quotes but include a leading space.
-                For example:
-
-                    " -12" or " -99-86"
-
-                Allows you to pass a minus-twelve, or minus-ninety-nine through
-                eighty-six.
-
-            (Also see condenseseq).
-            '''),
-            usage="%(prog)s [OPTION]... [INTEGER SEQUENCE]...")
-    else :
-        p = argparse.ArgumentParser(
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        description=textwrap.dedent('''\
-            Condenses a list of integers and/or integer sequences of the form
-            'A-B' or 'A-BxN' into the most minimal sequence format possible to
-            represent the full list of numbers.
-
-                Helpful hint: To pass negative numbers as an argument enclose them
-                with quotes but include a leading space.
-                For example:
-
-                    " -12" or " -99-86"
-
-                Allows you to pass a minus-twelve, or minus-ninety-nine through
-                eighty-six.
-
-            (Also see expandseq).
-            '''),
-            usage="%(prog)s [OPTION]... [INTEGER SEQUENCE]...")
-
-    p.add_argument("--version", action="version", version=VERSION)
-    p.add_argument("--delimiter", "-d", action="store", type=str,
-        choices=("comma", "space", "newline"),
-        dest="seqDelimiter",
-        metavar="DELIMITER",
-        default="comma",
-        help="List successive numbers delimited by a 'comma' (default) or a 'space' or a 'newline'.")
-    if not EXPAND_MODE : # i.e.; condense
-        p.add_argument("--onlyOnes", action="store_true",
-            dest="onlyOnes", default=False,
-            help="only condense sucessive frames, that is, do not list sequences on 2's, 3's, ... N's")
-    p.add_argument("--pad", action="store", type=int,
-       dest="pad", default=1,
-       metavar="PAD",
-       help="set the padding of the frame numbers to be <PAD> digits. [default: 1]")
-    p.add_argument("--reverse", "-r", action="store_true",
-        dest="reverseList", default=False,
-        help="reverse the order of the list")
-    if EXPAND_MODE :
-        p.add_argument("--sort", "-s", action="store_true",
-            dest="sortList", default=False,
-            help="sort the resulting list")
-    p.add_argument("numSequences", metavar="INTEGER SEQUENCE", nargs="*",
-        help="is a single integer such as 'A', or a range \
-        of integers such as 'A-B' (A or B can be negative,\
-        and A may be greater than B to count backwards), or \
-        a range on N's such as 'A-BxN' where N is a positive integer.")
-
-    # Copy the command line args (except prog name) and convert
-    # commas into spaces thus making more args.
-    #
-    args = p.parse_args()
-
-    separateArgs = []
-    for a in args.numSequences :
-        for b in a.split(',') :
-            separateArgs.append(b)
-    remainingArgs = []
-    result = seqLister.expandSeq(separateArgs, remainingArgs)
-
-    if EXPAND_MODE :
-        if args.sortList :
-            result.sort()
-        # Pad list of integers and turn them into strings before printing.
-        #
-        ### jpr debug ### formatStr = "{0:0=-" + str(4) + "d}"
-        formatStr = "{0:0=-" + str(args.pad) + "d}"
-        paddedFrames = []
-        for frame in result:
-            paddedFrames.append(formatStr.format(frame))
-        result = paddedFrames
-    else :
-        if args.onlyOnes :
-            result = seqLister.condenseSeqOnes(result, args.pad)
-        else :
-            result = seqLister.condenseSeq(result, args.pad)
-
-    if args.reverseList :
-        result.reverse()
-
-    isFirst = True
-    for s in result :
-        if args.seqDelimiter == 'space' :
-            if not isFirst :
-                sys.stdout.write(' ')
-            sys.stdout.write(str(s))
-            isFirst = False
-        elif args.seqDelimiter == 'comma' :
-            if not isFirst :
-                sys.stdout.write(',')
-            sys.stdout.write(str(s))
-            isFirst = False
-        else : # newline
-            print(s)
-    if (args.seqDelimiter == 'comma' or args.seqDelimiter == 'space') and not isFirst :
-        print()
-
-if __name__ == '__main__':
-    main()