App-DownloadsDirUtils
view release on metacpan or search on metacpan
Number of results to return.
* recursive => *true*
Recurse into subdirectories.
* type => *str*
Only include files of certain type.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
code (200 means OK, 4xx caller error, 5xx function error). Second
element ($reason) is a string containing error message, or something
like "OK" if status is 200. Third element ($payload) is the actual
result, but usually not present when enveloped result is an error
response ($status_code is not 2xx). Fourth element (%result_meta) is
called result metadata and is optional, a hash that contains extra
information, much like how HTTP response headers provide additional
metadata.
Return value: (any)
list_downloads_dirs
Usage:
list_downloads_dirs() -> any
List downloads directories.
This function is not exported.
No arguments.
Return value: (any)
mv_foremost_download_here
Usage:
mv_foremost_download_here(%args) -> [$status_code, $reason, $payload, \%result_meta]
Move the foremost file(s) from the downloads directories to current
directory.
This is a thin wrapper for the foremost-download utility; the wrapper
moves the files to current directory. It hopes to be a convenient helper
to organize your downloads.
This function is not exported.
This function supports dry-run operation.
Arguments ('*' denotes required arguments):
* all => *true*
Do not ignore entries starting with .
* as => *pathname::unix::basename*
Rename file.
* detail => *true*
(No description)
* dirs => *array[dirname]* (default: ["/home/u1/Downloads"])
Directory to sort files of, defaults to current directory.
* exclude_filename_pattern => *re_from_str* (default: "/\\.part\\z/")
Exclude filenames that match a regex pattern.
* ignore_case => *bool*
(No description)
* include_filename_pattern => *re_from_str*
Only include filenames that match a regex pattern.
* num_ranks => *uint*
Number of ranks to return.
Difference between "num_results" and "num_ranks": "num_results"
("-n" option) specifies number of results regardless of ranks while
"num_ranks" ("-N" option) returns number of ranks. For example, if
sorting is by reverse size and if "num_results" is set to 1 and
there are 2 files with the same largest size then only 1 of those
files will be returned. With "num_ranks" set to 1, both files will
be returned because are they both rank #1.
* num_results => *uint*
Number of results to return.
* overwrite => *true*
(No description)
* recursive => *true*
Recurse into subdirectories.
* to_dir => *dirname* (default: ".")
(No description)
* type => *str*
Only include files of certain type.
Special arguments:
* -dry_run => *bool*
Pass -dry_run=>1 to enable simulation mode.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
code (200 means OK, 4xx caller error, 5xx function error). Second
element ($reason) is a string containing error message, or something
like "OK" if status is 200. Third element ($payload) is the actual
result, but usually not present when enveloped result is an error
response ($status_code is not 2xx). Fourth element (%result_meta) is
called result metadata and is optional, a hash that contains extra
information, much like how HTTP response headers provide additional
metadata.
Return value: (any)
mv_hindmost_download_here
Usage:
mv_hindmost_download_here(%args) -> [$status_code, $reason, $payload, \%result_meta]
Move the hindmost file(s) from the downloads directories to current
directory.
This is a thin wrapper for the hindmost-download utility; the wrapper
moves the files to current directory. It hopes to be a convenient helper
to organize your downloads.
This function is not exported.
This function supports dry-run operation.
Arguments ('*' denotes required arguments):
* all => *true*
Do not ignore entries starting with .
* as => *pathname::unix::basename*
Rename file.
* detail => *true*
(No description)
* dirs => *array[dirname]* (default: ["/home/u1/Downloads"])
Directory to sort files of, defaults to current directory.
* exclude_filename_pattern => *re_from_str* (default: "/\\.part\\z/")
Exclude filenames that match a regex pattern.
* ignore_case => *bool*
(No description)
* include_filename_pattern => *re_from_str*
Only include filenames that match a regex pattern.
* num_ranks => *uint*
Number of ranks to return.
Difference between "num_results" and "num_ranks": "num_results"
("-n" option) specifies number of results regardless of ranks while
"num_ranks" ("-N" option) returns number of ranks. For example, if
sorting is by reverse size and if "num_results" is set to 1 and
there are 2 files with the same largest size then only 1 of those
files will be returned. With "num_ranks" set to 1, both files will
be returned because are they both rank #1.
* num_results => *uint*
Number of results to return.
* overwrite => *true*
(No description)
* recursive => *true*
Recurse into subdirectories.
* to_dir => *dirname* (default: ".")
(No description)
* type => *str*
Only include files of certain type.
Special arguments:
* -dry_run => *bool*
Pass -dry_run=>1 to enable simulation mode.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
code (200 means OK, 4xx caller error, 5xx function error). Second
element ($reason) is a string containing error message, or something
like "OK" if status is 200. Third element ($payload) is the actual
result, but usually not present when enveloped result is an error
response ($status_code is not 2xx). Fourth element (%result_meta) is
called result metadata and is optional, a hash that contains extra
information, much like how HTTP response headers provide additional
metadata.
Return value: (any)
mv_largest_download_here
Usage:
mv_largest_download_here(%args) -> [$status_code, $reason, $payload, \%result_meta]
Move the largest file(s) from the downloads directories to current
directory.
This is a thin wrapper for the largest-download utility; the wrapper
moves the files to current directory. It hopes to be a convenient helper
to organize your downloads.
This function is not exported.
This function supports dry-run operation.
Arguments ('*' denotes required arguments):
* all => *true*
Do not ignore entries starting with .
* as => *pathname::unix::basename*
Rename file.
* detail => *true*
(No description)
* dirs => *array[dirname]* (default: ["/home/u1/Downloads"])
Directory to sort files of, defaults to current directory.
* exclude_filename_pattern => *re_from_str* (default: "/\\.part\\z/")
Exclude filenames that match a regex pattern.
* include_filename_pattern => *re_from_str*
Only include filenames that match a regex pattern.
* num_ranks => *uint*
Number of ranks to return.
Difference between "num_results" and "num_ranks": "num_results"
("-n" option) specifies number of results regardless of ranks while
"num_ranks" ("-N" option) returns number of ranks. For example, if
sorting is by reverse size and if "num_results" is set to 1 and
there are 2 files with the same largest size then only 1 of those
files will be returned. With "num_ranks" set to 1, both files will
be returned because are they both rank #1.
* num_results => *uint*
Number of results to return.
* overwrite => *true*
(No description)
* recursive => *true*
Recurse into subdirectories.
* to_dir => *dirname* (default: ".")
(No description)
* type => *str*
Only include files of certain type.
Special arguments:
* -dry_run => *bool*
Pass -dry_run=>1 to enable simulation mode.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
code (200 means OK, 4xx caller error, 5xx function error). Second
element ($reason) is a string containing error message, or something
like "OK" if status is 200. Third element ($payload) is the actual
result, but usually not present when enveloped result is an error
response ($status_code is not 2xx). Fourth element (%result_meta) is
called result metadata and is optional, a hash that contains extra
information, much like how HTTP response headers provide additional
metadata.
Return value: (any)
mv_newest_download_here
Usage:
mv_newest_download_here(%args) -> [$status_code, $reason, $payload, \%result_meta]
Move the newest file(s) from the downloads directories to current
directory.
This is a thin wrapper for the newest-download utility; the wrapper
moves the files to current directory. It hopes to be a convenient helper
to organize your downloads.
This function is not exported.
This function supports dry-run operation.
Arguments ('*' denotes required arguments):
* all => *true*
Do not ignore entries starting with .
* as => *pathname::unix::basename*
Rename file.
* detail => *true*
(No description)
* dirs => *array[dirname]* (default: ["/home/u1/Downloads"])
Directory to sort files of, defaults to current directory.
* exclude_filename_pattern => *re_from_str* (default: "/\\.part\\z/")
Exclude filenames that match a regex pattern.
* include_filename_pattern => *re_from_str*
Only include filenames that match a regex pattern.
* num_ranks => *uint*
Number of ranks to return.
Difference between "num_results" and "num_ranks": "num_results"
("-n" option) specifies number of results regardless of ranks while
"num_ranks" ("-N" option) returns number of ranks. For example, if
sorting is by reverse size and if "num_results" is set to 1 and
there are 2 files with the same largest size then only 1 of those
files will be returned. With "num_ranks" set to 1, both files will
be returned because are they both rank #1.
* num_results => *uint*
Number of results to return.
* overwrite => *true*
(No description)
* recursive => *true*
Recurse into subdirectories.
* to_dir => *dirname* (default: ".")
(No description)
* type => *str*
Only include files of certain type.
Special arguments:
* -dry_run => *bool*
Pass -dry_run=>1 to enable simulation mode.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
code (200 means OK, 4xx caller error, 5xx function error). Second
element ($reason) is a string containing error message, or something
like "OK" if status is 200. Third element ($payload) is the actual
result, but usually not present when enveloped result is an error
response ($status_code is not 2xx). Fourth element (%result_meta) is
called result metadata and is optional, a hash that contains extra
information, much like how HTTP response headers provide additional
metadata.
Return value: (any)
mv_oldest_download_here
Usage:
mv_oldest_download_here(%args) -> [$status_code, $reason, $payload, \%result_meta]
Move the oldest file(s) from the downloads directories to current
directory.
This is a thin wrapper for the oldest-download utility; the wrapper
moves the files to current directory. It hopes to be a convenient helper
to organize your downloads.
This function is not exported.
This function supports dry-run operation.
Arguments ('*' denotes required arguments):
* all => *true*
Do not ignore entries starting with .
* as => *pathname::unix::basename*
Rename file.
* detail => *true*
(No description)
* dirs => *array[dirname]* (default: ["/home/u1/Downloads"])
Directory to sort files of, defaults to current directory.
* exclude_filename_pattern => *re_from_str* (default: "/\\.part\\z/")
Exclude filenames that match a regex pattern.
* include_filename_pattern => *re_from_str*
Only include filenames that match a regex pattern.
* num_ranks => *uint*
Number of ranks to return.
Difference between "num_results" and "num_ranks": "num_results"
("-n" option) specifies number of results regardless of ranks while
"num_ranks" ("-N" option) returns number of ranks. For example, if
sorting is by reverse size and if "num_results" is set to 1 and
there are 2 files with the same largest size then only 1 of those
files will be returned. With "num_ranks" set to 1, both files will
be returned because are they both rank #1.
* num_results => *uint*
Number of results to return.
* overwrite => *true*
(No description)
* recursive => *true*
Recurse into subdirectories.
* to_dir => *dirname* (default: ".")
(No description)
* type => *str*
Only include files of certain type.
Special arguments:
* -dry_run => *bool*
Pass -dry_run=>1 to enable simulation mode.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
code (200 means OK, 4xx caller error, 5xx function error). Second
element ($reason) is a string containing error message, or something
like "OK" if status is 200. Third element ($payload) is the actual
result, but usually not present when enveloped result is an error
response ($status_code is not 2xx). Fourth element (%result_meta) is
called result metadata and is optional, a hash that contains extra
information, much like how HTTP response headers provide additional
metadata.
Return value: (any)
mv_smallest_download_here
Usage:
mv_smallest_download_here(%args) -> [$status_code, $reason, $payload, \%result_meta]
Move the smallest file(s) from the downloads directories to current
directory.
This is a thin wrapper for the smallest-download utility; the wrapper
moves the files to current directory. It hopes to be a convenient helper
to organize your downloads.
This function is not exported.
This function supports dry-run operation.
Arguments ('*' denotes required arguments):
* all => *true*
Do not ignore entries starting with .
* as => *pathname::unix::basename*
Rename file.
* detail => *true*
(No description)
* dirs => *array[dirname]* (default: ["/home/u1/Downloads"])
Directory to sort files of, defaults to current directory.
* exclude_filename_pattern => *re_from_str* (default: "/\\.part\\z/")
Exclude filenames that match a regex pattern.
* include_filename_pattern => *re_from_str*
Only include filenames that match a regex pattern.
* num_ranks => *uint*
Number of ranks to return.
Difference between "num_results" and "num_ranks": "num_results"
("-n" option) specifies number of results regardless of ranks while
"num_ranks" ("-N" option) returns number of ranks. For example, if
sorting is by reverse size and if "num_results" is set to 1 and
there are 2 files with the same largest size then only 1 of those
files will be returned. With "num_ranks" set to 1, both files will
be returned because are they both rank #1.
* num_results => *uint*
Number of results to return.
* overwrite => *true*
(No description)
* recursive => *true*
Recurse into subdirectories.
* to_dir => *dirname* (default: ".")
(No description)
* type => *str*
Only include files of certain type.
Special arguments:
* -dry_run => *bool*
Pass -dry_run=>1 to enable simulation mode.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status
( run in 1.200 second using v1.01-cache-2.11-cpan-64ef6c95b5d )