car: an archiving utility
an archiving utility for C64 OS
usage: car [-h] ...
subcommands
Possible choices: create, c, apppend, a, extract, e, merge, m, list, l, info, i
Sub-commands
create (c)
create a new archive
car create [-h] [-o OUTPUT] [-t {general,restore,install}] [--note NOTE]
[-s | -p] [--recursive | --no-recursive] [--no-empty-dir]
[--remove-files] [--exclude EXCLUDE] [--sort]
file [file ...]
Positional Arguments
- file
path to file or directory to be added to archive
Named Arguments
- -o, --output
write output to specified file (instead of stdout)
Default: <_io.BufferedWriter name=’<stdout>’>
- -t, --type
Possible choices: general, restore, install
set the archive type (default: general)
Default: “general”
- --note
set the archive note field
Default: “”
- -s, --seq
add files using the SEQ type (default)
Default: CarRecordType.SEQFILE
- -p, --prg
add files using the PRG type
Default: CarRecordType.SEQFILE
- --recursive
add directory contents recursively (default)
Default: True
- --no-recursive
do not add directory contents recursively
Default: True
- --no-empty-dir
do not add empty directories
Default: False
- --remove-files
remove files from disk after adding them to the archive
Default: False
- --exclude
exclude files matching the provided glob-style wildcard pattern
- --sort
when creating an archive, sort directory and file entries according to their name
Default: False
apppend (a)
append files to the end of an archive
car apppend [-h] [-o OUTPUT | -i] [-t {general,restore,install}] [--note NOTE]
[-s | -p] [--recursive | --no-recursive] [--no-empty-dir]
[--remove-files] [--exclude EXCLUDE] [--sort]
archive file [file ...]
Positional Arguments
- archive
path to archive file
- file
path to file or directory to be added to archive
Named Arguments
- -o, --output
write output to specified file (instead of stdout)
Default: <_io.BufferedWriter name=’<stdout>’>
- -i, --in-place
operate directly on the input file (instead of generating a new output)
Default: False
- -t, --type
Possible choices: general, restore, install
change the archive type
- --note
change the archive note field
- -s, --seq
add files using the SEQ type (default)
Default: CarRecordType.SEQFILE
- -p, --prg
add files using the PRG type
Default: CarRecordType.SEQFILE
- --recursive
add directory contents recursively (default)
Default: True
- --no-recursive
do not add directory contents recursively
Default: True
- --no-empty-dir
do not add empty directories
Default: False
- --remove-files
remove files from disk after adding them to the archive
Default: False
- --exclude
exclude files matching the provided glob-style wildcard pattern
- --sort
after appending, re-sort directory and file entries according to their name
Default: False
extract (e)
extract files from an archive
car extract [-h] [-o OUTPUT] [--no-seq | --no-prg] [--no-empty-dir] [-f | -k]
archive [archive ...]
Positional Arguments
- archive
path to archive file
Named Arguments
- -o, --output
create files in the specified directory (instead of current directory)
Default: “/home/docs/checkouts/readthedocs.org/user_builds/c64os-util/checkouts/latest/docs”
- --no-seq
do not extract files of type SEQ
Default: False
- --no-prg
do not extract files of type PRG
Default: False
- --no-empty-dir
do not create empty directories
Default: False
- -f, --force
silently overwrite existing files
Default: False
- -k, --skip
silently skip over existing files
Default: False
merge (m)
merge multiple archives into one
car merge [-h] [-o OUTPUT] [-t {general,restore,install}] [--note NOTE]
[--sort]
archive [archive ...]
Positional Arguments
- archive
path to archive file
Named Arguments
- -o, --output
write output to specified file (instead of stdout)
Default: <_io.BufferedWriter name=’<stdout>’>
- -t, --type
Possible choices: general, restore, install
change the archive type
- --note
change the archive note field.
- --sort
after concatenating, re-sort directory and file entries according to their name
Default: False
list (l)
list the files and directories within an archive
car list [-h] [-n DEPTH] archive base
Positional Arguments
- archive
path to archive file
- base
base starting path within the archive (defaults to root)
Default: “”
Named Arguments
- -n, --depth
limit list to n directories deep
Default: -1
info (i)
read or write metadata on an archive
car info [-h] archive {type,note,timestamp} [value]
Positional Arguments
- archive
path to archive file
- field
Possible choices: type, note, timestamp
field to read from or write to
- value
new value to write (omit for read)
run ‘%(prog)s <subcommand> -h’ for more information