Changelog: slk_helpers v1.8.10#

Update from slk_helpers v1.8.2 to v1.8.10

see here for changes from slk_helpers v1.7.4 to v1.8.2

see here for changes from slk_helpers v1.7.1 to v1.7.4

see here for changes from slk_helpers v1.6.0 to v1.7.1

see here for changes from slk_helpers v1.5.8 to v1.6.0

see here for changes from slk_helpers v1.5.7 to v1.5.7

see here for changes from slk_helpers v1.2.x to v1.5.7

Please have a look here for a detailed description of the new features and here for an incremental changelog.

Major changes#

  • iscached accepts search ids, resource ids and namespaces/directories (with -R appended) as input and it got the flags -v and -vv for verbose output

  • group_files_by_tape got many new input parameters:
    • JSON output: --json and --json-pretty

    • verbose mode: -v and -vv

    • use search query as input --search-query '<search_query>'

    • searches for more than one tape: --set-max-tape-number-per-search <N> / --smtnps <N>

    • --count-tapes

    • --full

    • --details

Changes that might break established workflows#

  • resource_type and resource_permissions: expect a resource path by default xor a resource id via --resource-id

  • group_files_by_tape: width of status in normal text output (value in brackets) increased by one

  • please use resource_path instead of resourcepath; the latter might be deprecated and removed in future

All fixes and new features#

  • general:
    • minor bugfixes in the error output messages

    • properly exit when wrong parameters are provided (in some situations)

    • new flag --help <command> to print the help for a specific command; e.g. slk_helpers --help mkdir will print the help for mkdir

    • new hidden flag --pid will print the Linux process id of the Java virtual machine

    • no command help is printed when a command is used the wrong way

    • fixed: commands which expect a list of Strings did not recognize wrong parameters but interpreted them as items of the list

    • new commands: searchid_exists and has_flag_partial

  • checksum: did not work after update to 1.8.1

  • iscached:
    • fixed a bug which caused iscached not to work properly in 1.8.2

    • also accepts search ids (via flag --search-id) and resource ids (via flag --resource-id) in addition to resource paths and resource ids

    • accepts a directory/namespace as input (with -R set)

    • got the flags -v and -vv for verbose and double verbose mode, respectively

  • resource_type and resource_permissions: expect a resource path by default xor a resource id via --resource-id

  • size: accepts resource ids (via flag --resource-id) in addition to resource paths

  • group_files_by_tape
    • new flags --json and --json-pretty to print output as JSON

    • new flags -v (same as --print-progress) and -vv for verbose and double-verbose output, respectively

    • new parameter --search-query '<search_query>'

    • new parameter --set-max-tape-number-per-search <N> / --smtnps <N> which causes the searches to be run not for one tape but for a maximum of N tapes – only if less than 50 files are to be retrieved per search and only for N <= 2

    • internal searches are performed differently; partly more efficient

    • width of status in normal text output (value in brackets) increased by one

    • minor bug fixes

  • gen_file_query
    • --not-cached (currently not working) and --tape-barcodes TAPE1,TAPE2,...

    • minor bug fixes

  • tape_status: fixed that tape status was not properly printed

  • command job_queue has new optional argument -i <INTERPRET_TYPE> / --interpret <INTERPRET_TYPE> with these values for INTERPRET_TYPE (case insensitive):
    • RAW/R: same as argument not set

    • TEXT/T: print short textual interpretation of the queue status => none, short, medium, long, jammed

    • DETAILS/D: print detailed textual interpretation of the queue status

    • NUMERIC/N: print a number representing the queue status => 0 (==none), 1 (==short), …, 4 (==jammed)