expandSeq 3.0.0__py3-none-any.whl → 4.0.1__py3-none-any.whl

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/__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.dist-info → expandseq-4.0.1.dist-info}/METADATA

@@ -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,9 +14,20 @@ 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)
-
-# 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
@@ -39,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
 
@@ -53,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
@@ -99,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
 ```
 
@@ -133,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-4.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+condenseseq/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+condenseseq/__main__.py,sha256=Sl3DmZAxiJbfgl5iSDD1L4U_s8Mf1hXhHuG5WfiC4rQ,9119
+expandseq/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+expandseq/__main__.py,sha256=XHh84OX3kb5APts_9yBO0j4gPkE5za9NWqmAuRvK4sE,8664
+expandseq-4.0.1.dist-info/licenses/LICENSE,sha256=6nkMza9EsLm_5eVujz579iCb9pLToaliSRuycs41Z28,1620
+expandseq-4.0.1.dist-info/METADATA,sha256=5JT4gkSFMN9j482Myh6ZOELBJ5qvifoFZyGLzA05jFU,8012
+expandseq-4.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+expandseq-4.0.1.dist-info/entry_points.txt,sha256=jPMAMCyVL3KeArm7ZsjKIxP_DoJF-k47q9nOSTJ2I78,94
+expandseq-4.0.1.dist-info/top_level.txt,sha256=RdXBSEQ2TUgy7KyzH1P0KkXp9U4gfjdr7ikaCt9TNNQ,22
+expandseq-4.0.1.dist-info/RECORD,,

{expandSeq-3.0.0.dist-info → expandseq-4.0.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

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

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

{expandSeq-3.0.0.dist-info → expandseq-4.0.1.dist-info/licenses}/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.dist-info/RECORD

@@ -1,10 +0,0 @@
-condenseseq/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-condenseseq/__main__.py,sha256=_flh6mRK7XXd-sL73Iow9P-VwQc_lVM9lmmVPOMFlJI,9103
-expandseq/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-expandseq/__main__.py,sha256=hlcNX0iucoz0yrwYRU7eg3D3X6di3Jfwhe2UAkiKpJc,8649
-expandSeq-3.0.0.dist-info/LICENSE,sha256=R6fdEb8ZKpCYTdOM-ZNPs2bVjqLdDfUwiDcx1xP0dCk,1620
-expandSeq-3.0.0.dist-info/METADATA,sha256=0sUSiA3a3Hrvq8P8m6phyfaBU4zAMhT4N0kf7x-ja_c,4802
-expandSeq-3.0.0.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-expandSeq-3.0.0.dist-info/entry_points.txt,sha256=PJBBLVjJavHNbnATRtL5WOGxo3PdC0n4I7j6FNpVz2c,95
-expandSeq-3.0.0.dist-info/top_level.txt,sha256=RdXBSEQ2TUgy7KyzH1P0KkXp9U4gfjdr7ikaCt9TNNQ,22
-expandSeq-3.0.0.dist-info/RECORD,,