expandSeq 3.0.0__tar.gz → 4.0.1__tar.gz

{expandSeq-3.0.0 → expandseq-4.0.1}/LICENSE

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

{expandSeq-3.0.0 → expandseq-4.0.1}/PKG-INFO

@@ -1,14 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: expandSeq
-Version: 3.0.0
+Version: 4.0.1
 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
+License: BSD-3-Clause
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: Unix
 Classifier: Operating System :: MacOS
@@ -16,8 +14,20 @@ Classifier: Development Status :: 5 - Production/Stable
 Requires-Python: >=3.6, <4
 Description-Content-Type: text/markdown
 License-File: LICENSE
-
-# About expandseq and consdenseseq
+Requires-Dist: seqLister>=1.1.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# About expandseq and condenseseq
 
 `expandseq` and `condenseseq` are two unix/linux command-line utilitiies 
 for expanding and condensing
@@ -38,13 +48,15 @@ frame-ranges is one of the following three cases:
 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 often be combined to describe
+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
+```
+python3 -m pip install expandSeq --upgrade
+```
 
 ## Testing the installation
 
@@ -52,9 +64,9 @@ 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
+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
+1-4 5-15x2
 ```
 
 ## expandseq
@@ -98,7 +110,7 @@ optional arguments:
   --reverse, -r         reverse the order of the list
   --sort, -s            sort the resulting list
   --error               exit with error if FRAME-RANGE is invalid. (default)
-  --noError             skip invalid FRAME-RANGEs, but print warning
+  --no-error             skip invalid FRAME-RANGEs, but print warning
   --silent, --quiet     suppress all errors and warnings
 ```
 
@@ -132,14 +144,109 @@ optional arguments:
   --delimiter DELIMITER, -d DELIMITER
                         List successive numbers delimited by a 'comma',
                         'space' (default) or a 'newline'.
-  --onlyOnes            only condense sucessive frames, that is, do not list
+  --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)
-  --noError             skip invalid FRAME-RANGEs, but print warning
+  --no-error             skip invalid FRAME-RANGEs, but print warning
   --silent, --quiet     suppress all errors and warnings
 
 ```
 
+# Important: latest MAJOR point release of `expandseq`.
+
+`expandseq` and `condenseseq` as well as all
+the utilities provided by jrowellfx github repos
+use "[`Semantic Versioning 2.0.0`](https://semver.org/)" in numbering releases.
+The latest release of `expandseq` upped the `MAJOR` release number
+from `v3.x.x` to `v4.x.x`.
+
+While the functionality and output of neither `expandseq` nor
+`condenseseq` has changed, all the so called
+"long options" have been renamed to adhere to `POSIX` standard naming
+conventions.
+
+That is, prior to `v4.0.0` of `expandseq` all the long-option names used a "camel case"
+naming convention but as of `v4.0.0` all long-option names have been
+changed to so-called "kebab case".
+
+For example:
+
+```
+--onlyOnes
+
+```
+
+has been changed to
+
+```
+--only-ones
+```
+
+In the event that you have written any scripts that make use of `expandseq`,
+`condenseseq` or
+any other of `jrowellfx`'s utils provided [here](https://github.com/jrowellfx) 
+you will need to edit your scripts to be able to update to the lastest versions
+of the utilities.
+
+In this case, in order to assist in switching to the
+current `MAJOR` point release some `sed` scripts have been provided that should make
+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:
+`sed.script.jrowellfx.doubleDashToKebab` and `sed.script.expandseq.v3tov4`.
+
+The first one can be used to fix the long-option names for ALL the 
+`MAJOR` point release updates to the long-options in any of `jrowellfx`'s utilities.
+The second one contains only changes needed for the updates to `expandseq`
+or `condenseseq`.
+
+## Example `sed.script` usage.
+
+Download one or both of the sed scripts named above. Make sure you have `runsed` installed
+on your system. (Example applied to usage of `lsseq` but it's
+the same idea for `expandseq`.)
+
+```
+$ cd ~/bin
+$ ls
+myScriptThatUsesLsseq
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+
+$ mv ~/Downloads/sed.script.jrowellfx.doubleDashToKebab sed.script
+$ runsed myScriptThatUsesLsseq
+$ ./.runsed.diff.runsed
++ /usr/bin/diff ./.myScriptThatUsesLsseq.runsed myScriptThatUsesLsseq
+3c3
+< lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+---
+> lsseq --global-sort-by-time --recursive --prepend-path-abs /Volumes/myProjectFiles
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --global-sort-by-time --recursive --prepend-path-abs /Volumes/myProjectFiles
+```
+
+Note that if you are unhappy with the changes you can undo them easily with
+
+```
+$ ./.runsed.undo.runsed
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+
+
+```
+
+## Contact
+
+Please contact `j a m e s <at> a l p h a - e l e v e n . c o m` with any bug
+reports, suggestions or praise as the case may be.
 

{expandSeq-3.0.0 → expandseq-4.0.1}/README.md

@@ -1,4 +1,4 @@
-# About expandseq and consdenseseq
+# About expandseq and condenseseq
 
 `expandseq` and `condenseseq` are two unix/linux command-line utilitiies 
 for expanding and condensing
@@ -19,13 +19,15 @@ frame-ranges is one of the following three cases:
 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 often be combined to describe
+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
+```
+python3 -m pip install expandSeq --upgrade
+```
 
 ## Testing the installation
 
@@ -33,9 +35,9 @@ 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
+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
+1-4 5-15x2
 ```
 
 ## expandseq
@@ -79,7 +81,7 @@ optional arguments:
   --reverse, -r         reverse the order of the list
   --sort, -s            sort the resulting list
   --error               exit with error if FRAME-RANGE is invalid. (default)
-  --noError             skip invalid FRAME-RANGEs, but print warning
+  --no-error             skip invalid FRAME-RANGEs, but print warning
   --silent, --quiet     suppress all errors and warnings
 ```
 
@@ -113,12 +115,109 @@ optional arguments:
   --delimiter DELIMITER, -d DELIMITER
                         List successive numbers delimited by a 'comma',
                         'space' (default) or a 'newline'.
-  --onlyOnes            only condense sucessive frames, that is, do not list
+  --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)
-  --noError             skip invalid FRAME-RANGEs, but print warning
+  --no-error             skip invalid FRAME-RANGEs, but print warning
   --silent, --quiet     suppress all errors and warnings
 
 ```
+
+# Important: latest MAJOR point release of `expandseq`.
+
+`expandseq` and `condenseseq` as well as all
+the utilities provided by jrowellfx github repos
+use "[`Semantic Versioning 2.0.0`](https://semver.org/)" in numbering releases.
+The latest release of `expandseq` upped the `MAJOR` release number
+from `v3.x.x` to `v4.x.x`.
+
+While the functionality and output of neither `expandseq` nor
+`condenseseq` has changed, all the so called
+"long options" have been renamed to adhere to `POSIX` standard naming
+conventions.
+
+That is, prior to `v4.0.0` of `expandseq` all the long-option names used a "camel case"
+naming convention but as of `v4.0.0` all long-option names have been
+changed to so-called "kebab case".
+
+For example:
+
+```
+--onlyOnes
+
+```
+
+has been changed to
+
+```
+--only-ones
+```
+
+In the event that you have written any scripts that make use of `expandseq`,
+`condenseseq` or
+any other of `jrowellfx`'s utils provided [here](https://github.com/jrowellfx) 
+you will need to edit your scripts to be able to update to the lastest versions
+of the utilities.
+
+In this case, in order to assist in switching to the
+current `MAJOR` point release some `sed` scripts have been provided that should make
+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:
+`sed.script.jrowellfx.doubleDashToKebab` and `sed.script.expandseq.v3tov4`.
+
+The first one can be used to fix the long-option names for ALL the 
+`MAJOR` point release updates to the long-options in any of `jrowellfx`'s utilities.
+The second one contains only changes needed for the updates to `expandseq`
+or `condenseseq`.
+
+## Example `sed.script` usage.
+
+Download one or both of the sed scripts named above. Make sure you have `runsed` installed
+on your system. (Example applied to usage of `lsseq` but it's
+the same idea for `expandseq`.)
+
+```
+$ cd ~/bin
+$ ls
+myScriptThatUsesLsseq
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+
+$ mv ~/Downloads/sed.script.jrowellfx.doubleDashToKebab sed.script
+$ runsed myScriptThatUsesLsseq
+$ ./.runsed.diff.runsed
++ /usr/bin/diff ./.myScriptThatUsesLsseq.runsed myScriptThatUsesLsseq
+3c3
+< lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+---
+> lsseq --global-sort-by-time --recursive --prepend-path-abs /Volumes/myProjectFiles
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --global-sort-by-time --recursive --prepend-path-abs /Volumes/myProjectFiles
+```
+
+Note that if you are unhappy with the changes you can undo them easily with
+
+```
+$ ./.runsed.undo.runsed
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+
+
+```
+
+## Contact
+
+Please contact `j a m e s <at> a l p h a - e l e v e n . c o m` with any bug
+reports, suggestions or praise as the case may be.
+

{expandSeq-3.0.0 → expandseq-4.0.1}/condenseseq/__main__.py

@@ -2,7 +2,7 @@
 
 # 3-Clause BSD License
 # 
-# Copyright (c) 2008-2023, James Philip Rowell,
+# Copyright (c) 2008-2026, James Philip Rowell,
 # Alpha Eleven Incorporated
 # www.alpha-eleven.com
 # All rights reserved.
@@ -52,7 +52,7 @@ import seqLister
 # MINOR version for added functionality in a backwards compatible manner
 # PATCH version for backwards compatible bug fixes
 #
-VERSION     = "3.0.0"
+VERSION     = "4.0.1"
 
 PROG_NAME = "condenseseq"
 
@@ -108,7 +108,7 @@ def main():
 
             (Also see expandseq).
             '''),
-        usage="%(prog)s [OPTION]... [FRAME-RANGE]...")
+        usage="%(prog)s [-h | --help] [OPTION]... [FRAME-RANGE]...")
 
     p.add_argument("--version", action="version", version=VERSION)
     p.add_argument("--delimiter", "-d", action="store", type=str,
@@ -117,7 +117,7 @@ def main():
         metavar="DELIMITER",
         default="space",
         help="List successive numbers delimited by a 'comma', 'space' (default) or a 'newline'.")
-    p.add_argument("--onlyOnes", action="store_true",
+    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,
@@ -128,7 +128,7 @@ def main():
     p.add_argument("--error", action="store_true",
         dest="exitOnError", default=True,
         help="exit with error if FRAME-RANGE is invalid. (default)" )
-    p.add_argument("--noError", action="store_false",
+    p.add_argument("--no-error", action="store_false",
         dest="exitOnError",
         help="skip invalid FRAME-RANGEs, but print warning" )
 

{expandSeq-3.0.0 → expandseq-4.0.1}/expandSeq.egg-info/PKG-INFO

@@ -1,14 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: expandSeq
-Version: 3.0.0
+Version: 4.0.1
 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
+License: BSD-3-Clause
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: Unix
 Classifier: Operating System :: MacOS
@@ -16,8 +14,20 @@ Classifier: Development Status :: 5 - Production/Stable
 Requires-Python: >=3.6, <4
 Description-Content-Type: text/markdown
 License-File: LICENSE
-
-# About expandseq and consdenseseq
+Requires-Dist: seqLister>=1.1.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# About expandseq and condenseseq
 
 `expandseq` and `condenseseq` are two unix/linux command-line utilitiies 
 for expanding and condensing
@@ -38,13 +48,15 @@ frame-ranges is one of the following three cases:
 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 often be combined to describe
+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
+```
+python3 -m pip install expandSeq --upgrade
+```
 
 ## Testing the installation
 
@@ -52,9 +64,9 @@ 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
+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
+1-4 5-15x2
 ```
 
 ## expandseq
@@ -98,7 +110,7 @@ optional arguments:
   --reverse, -r         reverse the order of the list
   --sort, -s            sort the resulting list
   --error               exit with error if FRAME-RANGE is invalid. (default)
-  --noError             skip invalid FRAME-RANGEs, but print warning
+  --no-error             skip invalid FRAME-RANGEs, but print warning
   --silent, --quiet     suppress all errors and warnings
 ```
 
@@ -132,14 +144,109 @@ optional arguments:
   --delimiter DELIMITER, -d DELIMITER
                         List successive numbers delimited by a 'comma',
                         'space' (default) or a 'newline'.
-  --onlyOnes            only condense sucessive frames, that is, do not list
+  --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)
-  --noError             skip invalid FRAME-RANGEs, but print warning
+  --no-error             skip invalid FRAME-RANGEs, but print warning
   --silent, --quiet     suppress all errors and warnings
 
 ```
 
+# Important: latest MAJOR point release of `expandseq`.
+
+`expandseq` and `condenseseq` as well as all
+the utilities provided by jrowellfx github repos
+use "[`Semantic Versioning 2.0.0`](https://semver.org/)" in numbering releases.
+The latest release of `expandseq` upped the `MAJOR` release number
+from `v3.x.x` to `v4.x.x`.
+
+While the functionality and output of neither `expandseq` nor
+`condenseseq` has changed, all the so called
+"long options" have been renamed to adhere to `POSIX` standard naming
+conventions.
+
+That is, prior to `v4.0.0` of `expandseq` all the long-option names used a "camel case"
+naming convention but as of `v4.0.0` all long-option names have been
+changed to so-called "kebab case".
+
+For example:
+
+```
+--onlyOnes
+
+```
+
+has been changed to
+
+```
+--only-ones
+```
+
+In the event that you have written any scripts that make use of `expandseq`,
+`condenseseq` or
+any other of `jrowellfx`'s utils provided [here](https://github.com/jrowellfx) 
+you will need to edit your scripts to be able to update to the lastest versions
+of the utilities.
+
+In this case, in order to assist in switching to the
+current `MAJOR` point release some `sed` scripts have been provided that should make
+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:
+`sed.script.jrowellfx.doubleDashToKebab` and `sed.script.expandseq.v3tov4`.
+
+The first one can be used to fix the long-option names for ALL the 
+`MAJOR` point release updates to the long-options in any of `jrowellfx`'s utilities.
+The second one contains only changes needed for the updates to `expandseq`
+or `condenseseq`.
+
+## Example `sed.script` usage.
+
+Download one or both of the sed scripts named above. Make sure you have `runsed` installed
+on your system. (Example applied to usage of `lsseq` but it's
+the same idea for `expandseq`.)
+
+```
+$ cd ~/bin
+$ ls
+myScriptThatUsesLsseq
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+
+$ mv ~/Downloads/sed.script.jrowellfx.doubleDashToKebab sed.script
+$ runsed myScriptThatUsesLsseq
+$ ./.runsed.diff.runsed
++ /usr/bin/diff ./.myScriptThatUsesLsseq.runsed myScriptThatUsesLsseq
+3c3
+< lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+---
+> lsseq --global-sort-by-time --recursive --prepend-path-abs /Volumes/myProjectFiles
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --global-sort-by-time --recursive --prepend-path-abs /Volumes/myProjectFiles
+```
+
+Note that if you are unhappy with the changes you can undo them easily with
+
+```
+$ ./.runsed.undo.runsed
+$ cat myScriptThatUsesLsseq
+#!/bin/bash
+
+lsseq --globalSortByTime --recursive --prependPathAbs /Volumes/myProjectFiles
+
+
+```
+
+## Contact
+
+Please contact `j a m e s <at> a l p h a - e l e v e n . c o m` with any bug
+reports, suggestions or praise as the case may be.
 

{expandSeq-3.0.0 → expandseq-4.0.1}/expandSeq.egg-info/entry_points.txt

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

{expandSeq-3.0.0 → expandseq-4.0.1}/expandseq/__main__.py

@@ -2,7 +2,7 @@
 
 # 3-Clause BSD License
 # 
-# Copyright (c) 2008-2023, James Philip Rowell,
+# Copyright (c) 2008-2026, James Philip Rowell,
 # Alpha Eleven Incorporated
 # www.alpha-eleven.com
 # All rights reserved.
@@ -52,7 +52,7 @@ import seqLister
 # MINOR version for added functionality in a backwards compatible manner
 # PATCH version for backwards compatible bug fixes
 #
-VERSION     = "3.0.0"
+VERSION     = "4.0.1"
 
 PROG_NAME = "expandseq"
 
@@ -115,7 +115,7 @@ def main():
 
             (Also see condenseseq).
             '''),
-        usage="%(prog)s [OPTION]... [FRAME-RANGE]...")
+        usage="%(prog)s [-h | --help] [OPTION]... [FRAME-RANGE]...")
 
     p.add_argument("--version", action="version", version=VERSION)
     p.add_argument("--delimiter", "-d", action="store", type=str,
@@ -138,7 +138,7 @@ def main():
     p.add_argument("--error", action="store_true",
         dest="exitOnError", default=True,
         help="exit with error if FRAME-RANGE is invalid. (default)" )
-    p.add_argument("--noError", action="store_false",
+    p.add_argument("--no-error", action="store_false",
         dest="exitOnError",
         help="skip invalid FRAME-RANGEs, but print warning" )
 

{expandSeq-3.0.0 → expandseq-4.0.1}/setup.py

@@ -8,17 +8,18 @@ long_description = (here / 'README.md').read_text(encoding='utf-8')
 
 setup(
     name            = 'expandSeq',
-    version         = '3.0.0',
+    version         = '4.0.1',
     description='Command line utils to expose functionality of seqLister python library.',
     long_description=long_description,
     long_description_content_type='text/markdown',
     url             = 'https://github.com/jrowellfx/expandSeq',
     author          = 'James Philip Rowell',
     author_email    = 'james@alpha-eleven.com',
+    license         = "BSD-3-Clause",
+    license_files = ["LICENSE"],
 
     classifiers=[
         'Programming Language :: Python :: 3',
-        'License :: OSI Approved :: BSD License',
         'Operating System :: POSIX',
         'Operating System :: Unix',
         'Operating System :: MacOS',