cloudsh 0.0.0__tar.gz

cloudsh-0.0.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.3
+Name: cloudsh
+Version: 0.0.0
+Summary: A Python CLI wrapping common Linux commands for local/cloud files.
+Author: Your Name
+Author-email: you@example.com
+Requires-Python: >=3.9,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: all
+Provides-Extra: aws
+Provides-Extra: azure
+Provides-Extra: gcs
+Provides-Extra: gs
+Requires-Dist: argcomplete (>=3.5.3,<4.0.0)
+Requires-Dist: argx (>=0.2,<0.3)
+Requires-Dist: azure-storage-blob (>=12,<13) ; extra == "azure" or extra == "all"
+Requires-Dist: azure-storage-file-datalake (>=12,<13) ; extra == "azure" or extra == "all"
+Requires-Dist: boto3 (>=1.34,<2.0) ; extra == "aws" or extra == "all"
+Requires-Dist: cloudpathlib (>=0.20,<0.21)
+Requires-Dist: google-cloud-storage (>=2.19,<3.0) ; extra == "gs" or extra == "gcs" or extra == "all"
+Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)

cloudsh-0.0.0/cloudsh/__init__.py

@@ -0,0 +1,2 @@
+from . import cloudpathlib_patch
+from .utils import __version__

cloudsh-0.0.0/cloudsh/__main__.py

@@ -0,0 +1,4 @@
+from .main import main
+
+if __name__ == "__main__":
+    main()

cloudsh-0.0.0/cloudsh/args/cat.toml

@@ -0,0 +1,58 @@
+name = "cat"
+help = "Concatenate files and print on the standard output"
+description = """
+Concatenate FILE(s) to standard output.
+With no FILE, or when FILE is -, read standard input.
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+nargs = "*"
+help = "Files to concatenate (use - for stdin)"
+
+[[arguments]]
+flags = ["-A", "--show-all"]
+help = "equivalent to -vET"
+action = "store_true"
+
+[[arguments]]
+flags = ["-b", "--number-nonblank"]
+help = "number nonempty output lines, overrides -n"
+action = "store_true"
+
+[[arguments]]
+flags = ["-e"]
+help = "equivalent to -vE"
+action = "store_true"
+
+[[arguments]]
+flags = ["-E", "--show-ends"]
+help = "display $ at end of each line"
+action = "store_true"
+
+[[arguments]]
+flags = ["-n", "--number"]
+help = "number all output lines"
+action = "store_true"
+
+[[arguments]]
+flags = ["-s", "--squeeze-blank"]
+help = "suppress repeated empty output lines"
+action = "store_true"
+
+[[arguments]]
+flags = ["-t"]
+help = "equivalent to -vT"
+action = "store_true"
+
+[[arguments]]
+flags = ["-T", "--show-tabs"]
+help = "display TAB characters as ^I"
+action = "store_true"
+
+[[arguments]]
+flags = ["-v", "--show-nonprinting"]
+help = "use ^ and M- notation, except for LFD and TAB"
+action = "store_true"

cloudsh-0.0.0/cloudsh/args/complete.toml

@@ -0,0 +1,34 @@
+name = "complete"
+help = "Generate shell completion"
+description = """
+Generate shell completion script for the specified shell (bash, fish or zsh).
+Or update/clear completion cache for given cloud paths.
+"""
+path_options = "path"
+
+[[arguments]]
+flags = ["-s", "--shell"]
+help = "Shell to generate completion for. Detected automatically if not specified."
+choices = ["bash", "fish", "zsh"]
+
+[[arguments]]
+flags = ["path"]
+metavar = "Path"
+help = "Cloud paths to generate completion for"
+nargs = "*"
+
+[[arguments]]
+flags = ["-d", "--depth"]
+help = "Depth of directories to scan for completion from the buckets. -1 means no limit."
+type = "int"
+default = -1
+
+[[arguments]]
+flags = ["--update-cache"]
+help = "Update completion cache for given buckets"
+action = "store_true"
+
+[[arguments]]
+flags = ["--clear-cache"]
+help = "Clear completion cache for given buckets"
+action = "store_true"

cloudsh-0.0.0/cloudsh/args/cp.toml

@@ -0,0 +1,62 @@
+name = "cp"
+help = "Copy files and directories"
+description = """
+Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.
+"""
+path_options = ["SOURCE", "DEST", "target_directory"]
+
+[[arguments]]
+flags = ["SOURCE"]
+metavar = "SOURCE"
+help = "Source file(s) to copy"
+nargs = "+"
+
+[[arguments]]
+flags = ["DEST"]
+metavar = "DEST"
+help = "Destination file or directory"
+
+[[arguments]]
+flags = ["-r", "-R", "--recursive"]
+help = "Copy directories recursively"
+action = "store_true"
+
+[[arguments]]
+flags = ["-i", "--interactive"]
+help = "Prompt before overwrite"
+action = "store_true"
+
+[[arguments]]
+flags = ["-f", "--force"]
+help = "Force overwrite of existing files"
+action = "store_true"
+
+[[arguments]]
+flags = ["-n", "--no-clobber"]
+help = "Do not overwrite existing files"
+action = "store_true"
+
+[[arguments]]
+flags = ["-v", "--verbose"]
+help = "Explain what is being done"
+action = "store_true"
+
+[[arguments]]
+flags = ["-p", "--preserve"]
+help = "Preserve mode, ownership, timestamps"
+action = "store_true"
+
+[[arguments]]
+flags = ["-t", "--target-directory"]
+help = "Copy all SOURCE arguments into DIRECTORY"
+metavar = "DIRECTORY"
+
+[[arguments]]
+flags = ["-T", "--no-target-directory"]
+help = "Treat DEST as a normal file"
+action = "store_true"
+
+[[arguments]]
+flags = ["--parents"]
+help = "Use full source file name under DIRECTORY"
+action = "store_true"

cloudsh-0.0.0/cloudsh/args/head.toml

@@ -0,0 +1,52 @@
+usage = "cloudsh head [OPTION]... [FILE]..."
+description = """
+Print the first 10 lines of each FILE to standard output. With more than one FILE, precede each with a header giving the file name.
+When no FILE is given, read from standard input.
+
+With no FILE, or when FILE is -, read standard input.
+"""
+epilog = """
+NUM may have a multiplier suffix:
+b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
+GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q.
+Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
+For the orginal GNU head documentation, see:
+https://www.gnu.org/software/coreutils/head
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["-c", "--bytes"]
+metavar = "[-]NUM"
+help = "print the first NUM bytes of each file; with the leading '-', print all but the last NUM bytes of each file"
+type = "str"  # Changed from int to str to handle suffixes
+
+[[arguments]]
+flags = ["-n", "--lines"]
+metavar = "[-]NUM"
+default = "10"
+help = "print the first NUM lines instead of the first 10; with the leading '-', print all but the last NUM lines of each file"
+type = "str"  # Changed from int to str to handle suffixes
+
+[[arguments]]
+flags = ["-q", "--quiet", "--silent"]
+help = "never print headers giving file names"
+action = "store_true"
+
+[[arguments]]
+flags = ["-v", "--verbose"]
+help = "always print headers giving file names"
+action = "store_true"
+
+[[arguments]]
+flags = ["-z", "--zero-terminated"]
+help = "line delimiter is NUL, not newline"
+action = "store_true"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+nargs = "*"
+default = []
+action = "extend"
+help = "the file to read"

cloudsh-0.0.0/cloudsh/args/ls.toml

@@ -0,0 +1,64 @@
+usage = "cloudsh ls [OPTION]... [FILE]..."
+description = """
+List information about the FILEs (the current directory by default).
+Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["-a", "--all"]
+help = "do not ignore entries starting with ."
+action = "store_true"
+
+[[arguments]]
+flags = ["-A", "--almost-all"]
+help = "do not list implied . and .."
+action = "store_true"
+
+[[arguments]]
+flags = ["-l"]
+help = "use a long listing format"
+action = "store_true"
+
+[[arguments]]
+flags = ["-H", "--human-readable"]
+help = "with -l, print sizes like 1K 234M 2G etc."
+action = "store_true"
+
+[[arguments]]
+flags = ["--si"]
+help = "likewise, but use powers of 1000 not 1024"
+action = "store_true"
+
+[[arguments]]
+flags = ["-R", "--recursive"]
+help = "list subdirectories recursively"
+action = "store_true"
+
+[[arguments]]
+flags = ["-r", "--reverse"]
+help = "reverse order while sorting"
+action = "store_true"
+
+[[arguments]]
+flags = ["-S"]
+help = "sort by file size, largest first"
+action = "store_true"
+
+[[arguments]]
+flags = ["-t"]
+help = "sort by time, newest first"
+action = "store_true"
+
+[[arguments]]
+flags = ["-1"]
+dest = "one"
+help = "list one file per line"
+action = "store_true"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+nargs = "*"
+default = []
+help = "files to list"

cloudsh-0.0.0/cloudsh/args/mkdir.toml

@@ -0,0 +1,27 @@
+name = "mkdir"
+help = "Create directories"
+description = """
+Create the DIRECTORY(ies), if they do not already exist.
+"""
+path_options = "directory"
+
+[[arguments]]
+flags = ["directory"]
+metavar = "DIRECTORY"
+nargs = "+"
+help = "Directory(ies) to create"
+
+[[arguments]]
+flags = ["-m", "--mode"]
+help = "Set file mode (as in chmod), not a=rwx - umask. Ignored for cloud directories."
+type = "str"
+
+[[arguments]]
+flags = ["-p", "--parents"]
+help = "No error if existing, make parent directories as needed"
+action = "store_true"
+
+[[arguments]]
+flags = ["-v", "--verbose"]
+help = "Print a message for each created directory"
+action = "store_true"

cloudsh-0.0.0/cloudsh/args/mv.toml

@@ -0,0 +1,68 @@
+usage = """
+mv [OPTION]... [-T] SOURCE DEST
+mv [OPTION]... SOURCE... DIRECTORY
+mv [OPTION]... -t DIRECTORY SOURCE...
+"""
+help = "Move (rename) files"
+description = """
+Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY.
+"""
+path_options = ["SOURCE", "DEST", "target_directory"]
+
+[[arguments]]
+flags = ["SOURCE"]
+metavar = "SOURCE"
+nargs = "+"
+help = "Source file(s) to move"
+
+[[arguments]]
+flags = ["DEST"]
+metavar = "DEST"
+help = "Destination file or directory"
+
+[[arguments]]
+flags = ["-f", "--force"]
+help = "Do not prompt before overwriting"
+action = "store_true"
+
+[[arguments]]
+flags = ["-i", "--interactive"]
+help = "Prompt before overwrite"
+action = "store_true"
+
+[[arguments]]
+flags = ["-n", "--no-clobber"]
+help = "Do not overwrite an existing file"
+action = "store_true"
+
+[[arguments]]
+flags = ["-t", "--target-directory"]
+metavar = "DIRECTORY"
+help = "Move all SOURCE arguments into DIRECTORY"
+type = "str"
+
+[[arguments]]
+flags = ["-T", "--no-target-directory"]
+help = "Treat DEST as a normal file"
+action = "store_true"
+
+[[arguments]]
+flags = ["-v", "--verbose"]
+help = "Explain what is being done"
+action = "store_true"
+
+[[arguments]]
+flags = ["-u"]
+help = "equivalent to --update[=older]"
+action = "store_true"
+
+[[arguments]]
+flags = ["--update"]
+help = """Control which existing files are updated:
+'all' is default when --update not specified (replace all),
+'none' is like --no-clobber but skips don't cause failure,
+'older' is default when --update used (replace if older)"""
+choices = ["all", "none", "older"]
+default = "older"
+nargs = "?"
+const = "older"

cloudsh-0.0.0/cloudsh/args/rm.toml

@@ -0,0 +1,43 @@
+name = "rm"
+help = "Remove files or directories"
+description = """
+Remove (unlink) the FILE(s).
+By default, does not remove directories. Use --recursive (-r or -R) to remove directories.
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+nargs = "+"
+help = "File(s) to remove"
+
+[[arguments]]
+flags = ["-f", "--force"]
+help = "Ignore nonexistent files and arguments, never prompt"
+action = "store_true"
+
+[[arguments]]
+flags = ["-i"]
+help = "Prompt before every removal"
+action = "store_true"
+
+[[arguments]]
+flags = ["-I"]
+help = "Prompt once before removing more than three files or recursively"
+action = "store_true"
+
+[[arguments]]
+flags = ["-r", "-R", "--recursive"]
+help = "Remove directories and their contents recursively"
+action = "store_true"
+
+[[arguments]]
+flags = ["-d", "--dir"]
+help = "Remove empty directories"
+action = "store_true"
+
+[[arguments]]
+flags = ["-v", "--verbose"]
+help = "Explain what is being done"
+action = "store_true"

cloudsh-0.0.0/cloudsh/args/sink.toml

@@ -0,0 +1,16 @@
+name = "sink"
+help = "Save piped data to a file"
+description = """
+Save data from stdin to a file, either local or cloud.
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+help = "Target file path (local or cloud)"
+
+[[arguments]]
+flags = ["-a", "--append"]
+help = "Append to file instead of replacing"
+action = "store_true"

cloudsh-0.0.0/cloudsh/args/tail.toml

@@ -0,0 +1,85 @@
+usage = "cloudsh tail [OPTION]... [FILE]..."
+description = """
+Print the last 10 lines of each FILE to standard output.
+With more than one FILE, precede each with a header giving the file name.
+
+With no FILE, or when FILE is -, read standard input.
+"""
+epilog = """
+NUM may have a multiplier suffix:
+b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
+GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q.
+Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
+For the orginal GNU tail documentation, see:
+https://www.gnu.org/software/coreutils/tail
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["-c", "--bytes"]
+metavar = "[+]NUM"
+help = "output the last NUM bytes; or use -c +NUM to output starting with byte NUM of each file"
+type = "str"
+
+[[arguments]]
+flags = ["-f", "--follow"]
+help = "output appended data as the file grows"
+action = "store_true"
+
+[[arguments]]
+flags = ["-F"]
+help = "same as --follow=name --retry"
+action = "store_true"
+
+[[arguments]]
+flags = ["-n", "--lines"]
+metavar = "[+]NUM"
+default = "10"
+help = "output the last NUM lines, instead of the last 10; or use -n +NUM to output starting with line NUM"
+type = "str"
+
+[[arguments]]
+flags = ["--max-unchanged-stats"]
+metavar = "N"
+help = "with --follow=name, reopen a FILE which has not changed size after N iterations"
+type = "str"
+
+[[arguments]]
+flags = ["--pid"]
+metavar = "PID"
+help = "with -f, terminate after process ID, PID dies"
+type = "str"
+
+[[arguments]]
+flags = ["-q", "--quiet", "--silent"]
+help = "never output headers giving file names"
+action = "store_true"
+
+[[arguments]]
+flags = ["--retry"]
+help = "keep trying to open a file if it is inaccessible"
+action = "store_true"
+
+[[arguments]]
+flags = ["-s", "--sleep-interval"]
+metavar = "N"
+help = "with -f, sleep for approximately N seconds between iterations"
+type = "str"
+
+[[arguments]]
+flags = ["-v", "--verbose"]
+help = "always output headers giving file names"
+action = "store_true"
+
+[[arguments]]
+flags = ["-z", "--zero-terminated"]
+help = "line delimiter is NUL, not newline"
+action = "store_true"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+nargs = "*"
+default = []
+action = "extend"
+help = "the file to read"

cloudsh-0.0.0/cloudsh/args/touch.toml

@@ -0,0 +1,48 @@
+usage = "touch [OPTION]... FILE..."
+help = "Update file timestamps"
+description = """
+Update the access and modification times of each FILE to the current time.
+A FILE argument that does not exist is created empty, unless -c is supplied.
+"""
+path_options = "file"
+
+[[arguments]]
+flags = ["file"]
+metavar = "FILE"
+nargs = "+"
+help = "Files to touch"
+
+[[arguments]]
+flags = ["-a"]
+help = "Change only the access time"
+action = "store_true"
+
+[[arguments]]
+flags = ["-m"]
+help = "Change only the modification time"
+action = "store_true"
+
+[[arguments]]
+flags = ["-c", "--no-create"]
+help = "Do not create any files"
+action = "store_true"
+
+[[arguments]]
+flags = ["-d", "--date"]
+help = "Parse STRING and use it instead of current time"
+type = "str"
+
+[[arguments]]
+flags = ["-r", "--reference"]
+help = "Use this file's times instead of current time"
+type = "str"
+
+[[arguments]]
+flags = ["-t"]
+help = "Use [[CC]YY]MMDDhhmm[.ss] instead of current time"
+type = "str"
+
+[[arguments]]
+flags = ["--time"]
+choices = ["access", "atime", "use", "modify", "mtime"]
+help = "Change the specified time: access/atime/use='-a', modify/mtime='-m'"