luadocs/lua.scripts.api.manual/dtutils.file/details/index.html

1500 lines
35 KiB
HTML
Raw Normal View History

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="x-ua-compatible" content="ie=edge">
<title>darktable lua documentation - details</title>
<meta name="description" content="">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="manifest" href="site.webmanifest">
<link rel="apple-touch-icon" href="icon.png">
<link rel="stylesheet" href="https://elstoc.github.io/luadocs/css/style.min.6f8fcc9b0ebcd3ac477a507f922faefdf963732422cd88933d1d4783ebccb952.css">
<script src="https://elstoc.github.io/luadocs/js/jquery.js"></script>
<script src="https://elstoc.github.io/luadocs/js/popper.js" type="module"></script>
<script src="https://elstoc.github.io/luadocs/js/bootstrap.js"></script>
<script src="https://elstoc.github.io/luadocs/js/lunr.js"></script>
<script src="https://elstoc.github.io/luadocs/js/app.js"></script>
</head>
<body>
<header class="navbar navbar-expand-lg sticky-top navbar-dark bg-dark">
<a class="navbar-brand" href="https://elstoc.github.io/luadocs/" rel="home" title=".Site.Title">
darktable lua documentation
</a>
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="navbarSupportedContent">
<ul class="navbar-nav ml-auto">
<form class="form-inline my-2 my-lg-0">
<input id="search-input" class="form-control mr-sm-2" type="search" placeholder="Search" autocomplete="off" aria-label="Search">
</form>
</ul>
</div>
</header>
<div id="search-results" class="search-results">
</div>
<div class="container-fluid">
<div class="row">
<nav class="navigation col-sm-12 order-sm-12 col-md-3 order-md-1">
<ul>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/" class="">
Lua Scripts Manual
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/overview/" class="">
overview
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/installation/" class="">
installation
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/troubleshooting/" class="">
troubleshooting
</a>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/" class="">
scripts
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/overview/" class="">
overview
</a>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/" class="">
official
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/check_for_updates/" class="">
check_for_updates
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/copy_paste_metadata/" class="">
copy_paste_metadata
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/delete_long_tags/" class="">
delete_long_tags
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/delete_unused_tags/" class="">
delete_unused_tags
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/enfuse/" class="">
enfuse
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/generate_image_txt/" class="">
generate_image_txt
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/image_path_in_ui/" class="">
image_path_in_ui
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/import_filter_manager/" class="">
import_filter_manager
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/import_filters/" class="">
import_filters
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/save_selection/" class="">
save_selection
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/official/selection_to_pdf/" class="">
selection_to_pdf
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/" class="">
contrib
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/autogrouper/" class="">
AugoGrouper
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/autostyle/" class="">
autostyle
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/clear_gps/" class="">
clear_GPS
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/collecthelper/" class="">
CollectHelper
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/" class="">
copy_attach_detach_tags
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/cr2hdr/" class="">
cr2hdr
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/enfuseadvanced/" class="">
enfuseAdvanced
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/exportlut/" class="">
exportLUT
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/ext_editor/" class="">
ext_editor
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/face_recognition/" class="">
face_recognition
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_ratings/" class="">
fujifilm_ratings
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/geojson_export/" class="">
geoJSON_export
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/geotoolbox/" class="">
geoToolbox
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/gimp/" class="">
gimp
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/gpx_export/" class="">
gpx_export
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/hdrmerge/" class="">
HDRMerge
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/hugin/" class="">
hugin
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/image_stack/" class="">
image_stack
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/image_time/" class="">
image_time
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/kml_export/" class="">
kml_export
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/labelstotags/" class="">
LabelsToTags
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/openinexplorer/" class="">
OpenInExplorer
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/passport_guide/" class="">
passport_guide
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/pdf_slideshow/" class="">
pdf_slideshow
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/photils/" class="">
photils
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/quicktag/" class="">
quicktag
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/rate_group/" class="">
rate_group
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
rename_tags
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/rl_out_sharp/" class="">
RL_out_sharp
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/slideshowmusic/" class="">
slideshowMusic
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/transfer_hierarchy/" class="">
transfer_hierarchy
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/video_ffmpeg/" class="">
video_ffmpeg
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/contrib/select_untagged/" class="">
select_untagged
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/" class="">
examples
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/api_version/" class="">
api_version
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/darkroom_demo/" class="">
darkroom_demo
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/gettextexample/" class="">
gettextExample
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/hello_world/" class="">
hello_world
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/lighttable_demo/" class="">
lighttable_demo
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/moduleexample/" class="">
moduleExample
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/multi_os/" class="">
name
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/panels_demo/" class="">
panels_demo
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/preferenceexamples/" class="">
preferenceExample
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/printexamples/" class="">
printExamples
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/examples/running_os/" class="">
running_os
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/tools/" class="">
tools
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/tools/executable_manager/" class="">
executable_manager
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/tools/gen_i18n_mo/" class="">
gen_i18n_mo
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/tools/get_lib_manpages/" class="">
get_lib_manpages
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/tools/get_libdoc/" class="">
get_libdoc
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.manual/scripts/tools/script_manager/" class="">
script_manager
</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/" class="">
Lua Scripts Libraries API Manual
</a>
<ul>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/" class="">
dtutils
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/details/" class="">
details
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/check_min_api_version/" class="">
check_min_api_version
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/check_os/" class="">
check_os
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/join/" class="">
join
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/prequire/" class="">
prequire
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/spairs/" class="">
spairs
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils/split/" class="">
split
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.debug/" class="">
dtutils.debug
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.debug/details/" class="">
details
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.debug/dprint/" class="">
dprint
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.debug/new_tracepoint/" class="">
new_tracepoint
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.debug/terse_dump/" class="">
terse_dump
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.debug/tracepoint/" class="">
tracepoint
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/" class="">
dtutils.file
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/details/" class=" active">
details
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/" class="">
check_if_bin_exists
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/check_if_file_exists/" class="">
check_if_file_exists
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/chop_filetype/" class="">
chop_filetype
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/create_unique_filename/" class="">
create_unique_filename
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/executable_path_widget/" class="">
executable_path_widget
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/file_copy/" class="">
file_copy
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/file_move/" class="">
file_move
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/filename_increment/" class="">
filename_increment
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/get_basename/" class="">
get_basename
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/" class="">
get_executable_path_preference
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/get_filename/" class="">
get_filename
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/get_filetype/" class="">
get_filetype
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/get_path/" class="">
get_path
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/mkdir/" class="">
mkdir
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/rmdir/" class="">
rmdir
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/sanitize_filename/" class="">
sanitize_filename
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/" class="">
set_executable_path_preference
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/split_filepath/" class="">
split_filepath
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.log/" class="">
dtutils.log
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.log/details/" class="">
details
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.log/caller/" class="">
caller
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.log/engine/" class="">
engine
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.log/log_level/" class="">
log_level
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.log/msg/" class="">
msg
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/" class="">
dtutils.string
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/details/" class="">
details
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/escape_xml_characters/" class="">
escape_xml_characters
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/is_not_sanitized/" class="">
is_not_sanitized
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/sanitize/" class="">
sanitize
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/sanitize_lua/" class="">
sanitize_lua
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/strip_accents/" class="">
strip_accents
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.string/urlencode/" class="">
urlencode
</a>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.system/" class="">
dtutils.system
</a>
<ul>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.system/details/" class="">
details
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.system/external_command/" class="">
external_command
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.system/launch_default_app/" class="">
launch_default_app
</a>
</li>
<li>
<i class="no-toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.system/windows_command/" class="">
windows_command
</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="parent">
<i class="fa fa-plus-square toggle"></i>
<a href="https://elstoc.github.io/luadocs/lua.api/" class="">
Lua API Manual
</a>
<ul></ul>
</li>
</ul>
</nav>
<div class="content col-sm-12 order-sm-1 col-md-9 mx-md-auto order-md-12">
<div class="crumbs">
<span class="crumb">
<a href='https://elstoc.github.io/luadocs/'>Home</a> / <a href='https://elstoc.github.io/luadocs/lua.scripts.api.manual/'>Lua Scripts Libraries API Manual</a> / <a href='https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/'>dtutils.file</a> / details
</span>
</div>
<div class="prev-next row">
<div class="col-6">
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/" class="next">&lt; dtutils.file</a>
</div>
<div class="col-6">
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/" class="prev">check_if_bin_exists &gt;</a>
</div>
</div>
<article role="main">
<h1 class="title">
details
</h1>
<h2 id="name"><a href="#name">🔗</a>NAME</h2>
<p>details</p>
<h2 id="synopsis"><a href="#synopsis">🔗</a>SYNOPSIS</h2>
<p>common darktable lua file functions</p>
<h2 id="usage"><a href="#usage">🔗</a>USAGE</h2>
<pre><code>local df = require &quot;lib/dtutils.file&quot;
</code></pre><h2 id="description"><a href="#description">🔗</a>DESCRIPTION</h2>
<p>The <strong>dtutils.file</strong> library provides common file manipulation functions used in
constructing darktable lua scripts</p>
<h2 id="return-value"><a href="#return-value">🔗</a>RETURN VALUE</h2>
<p><strong>df</strong> - <em>library</em> - the file functions</p>
<h2 id="functions"><a href="#functions">🔗</a>FUNCTIONS</h2>
<h3 id="check_if_bin_existscheck_if_bin_existsmd"><a href="#check_if_bin_existscheck_if_bin_existsmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/">check_if_bin_exists</a></h3>
<p>check if an executable exists</p>
<h3 id="check_if_file_existscheck_if_file_existsmd"><a href="#check_if_file_existscheck_if_file_existsmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/check_if_file_exists/">check_if_file_exists</a></h3>
<p>check if a file or path exist</p>
<h3 id="chop_filetypechop_filetypemd"><a href="#chop_filetypechop_filetypemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/chop_filetype/">chop_filetype</a></h3>
<p>remove a filetype from a filename</p>
<h3 id="create_unique_filenamecreate_unique_filenamemd"><a href="#create_unique_filenamecreate_unique_filenamemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/create_unique_filename/">create_unique_filename</a></h3>
<p>create a unique filename from the supplied argment</p>
<h3 id="executable_path_widgetexecutable_path_widgetmd"><a href="#executable_path_widgetexecutable_path_widgetmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/executable_path_widget/">executable_path_widget</a></h3>
<p>create a widget to get executable path preferences</p>
<h3 id="file_copyfile_copymd"><a href="#file_copyfile_copymd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/file_copy/">file_copy</a></h3>
<p>copy a file to another name/location</p>
<h3 id="file_movefile_movemd"><a href="#file_movefile_movemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/file_move/">file_move</a></h3>
<p>move a file from one directory to another</p>
<h3 id="filename_incrementfilename_incrementmd"><a href="#filename_incrementfilename_incrementmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/filename_increment/">filename_increment</a></h3>
<p>add a two digit increment to a filename</p>
<h3 id="get_basenameget_basenamemd"><a href="#get_basenameget_basenamemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_basename/">get_basename</a></h3>
<p>get the filename without the path or extension</p>
<h3 id="get_executable_path_preferenceget_executable_path_preferencemd"><a href="#get_executable_path_preferenceget_executable_path_preferencemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/">get_executable_path_preference</a></h3>
<p>return the path to an executable from a preference</p>
<h3 id="get_filenameget_filenamemd"><a href="#get_filenameget_filenamemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_filename/">get_filename</a></h3>
<p>get the filename and extension from a file path</p>
<h3 id="get_filetypeget_filetypemd"><a href="#get_filetypeget_filetypemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_filetype/">get_filetype</a></h3>
<p>get the filetype from a filename</p>
<h3 id="get_pathget_pathmd"><a href="#get_pathget_pathmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_path/">get_path</a></h3>
<p>get the path from a file path</p>
<h3 id="mkdirmkdirmd"><a href="#mkdirmkdirmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/mkdir/">mkdir</a></h3>
<p>create the directory(ies) if they do not already exists</p>
<h3 id="rmdirrmdirmd"><a href="#rmdirrmdirmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/rmdir/">rmdir</a></h3>
<p>recursively remove a directory</p>
<h3 id="sanitize_filenamesanitize_filenamemd"><a href="#sanitize_filenamesanitize_filenamemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/sanitize_filename/">sanitize_filename</a></h3>
<p>make a filename safe to pass as an argument</p>
<h3 id="set_executable_path_preferenceset_executable_path_preferencemd"><a href="#set_executable_path_preferenceset_executable_path_preferencemd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/">set_executable_path_preference</a></h3>
<p>set a preference for the path to an executable</p>
<h3 id="split_filepathsplit_filepathmd"><a href="#split_filepathsplit_filepathmd">🔗</a><a href="/luadocs/lua.scripts.api.manual/dtutils.file/split_filepath/">split_filepath</a></h3>
<p>split a filepath into parts</p>
<h2 id="license"><a href="#license">🔗</a>LICENSE</h2>
<p>This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.</p>
</article>
<div class="prev-next row">
<div class="col-6">
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/" class="next">&lt; dtutils.file</a>
</div>
<div class="col-6">
<a href="https://elstoc.github.io/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/" class="prev">check_if_bin_exists &gt;</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>
<script>
(function($) {
$.fn.scrollToMiddle = function(options) {
var settings = $.extend({
duration: 0
}, options );
return this.each(function() {
var $el = $(this);
var elOffset = $el.offset().top;
var elHeight = $el.height();
var windowHeight = $(window).height();
var offset;
if (elHeight < windowHeight) {
offset = elOffset - ((windowHeight / 2) - (elHeight / 2));
}
else {
offset = elOffset;
}
$('.navigation').scrollTop(offset);
});
};
}(jQuery));
$('.navigation').css('opacity', '0');
$(document).ready(function(){
$('.parent ul').hide();
$('.navigation').css('opacity', 1.0);
$('.active').parents('ul').show();
$('.active').siblings('ul').show();
$('.active').children('i.toggle').removeClass("fa-plus-squre").addClass("fa-minus-square-o");
$('.active').parents('li').children('.toggle').removeClass("fa-plus-square").addClass("fa-minus-square-o");
$('.active').scrollToMiddle();
$('.toggle').on('click', function (e) {
e.stopPropagation();
$(this).siblings('ul').slideToggle();
if($(this).hasClass("fa-plus-square")) {
$(this).addClass("fa-minus-square-o");
$(this).removeClass("fa-plus-square");
}
else {
$(this).addClass("fa-plus-square");
$(this).removeClass("fa-minus-square-o");
}
});
});
</script>