forked/osxphotos
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Release files for 0.55.3 (#879)

Browse Source
This commit is contained in:
Rhet Turnbull
2022-12-19 09:08:07 -08:00
committed by GitHub
parent 00796f1c0a
commit a8586f911f
29 changed files with 891 additions and 711 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
docs/cli.html
View File

@@ -6,7 +6,7 @@
<link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="OSXPhotos Template System" href="template_help.html" /><link rel="prev" title="OSXPhotos Tutorial" href="tutorial.html" />
<meta name="generator" content="sphinx-5.3.0, furo 2022.09.29"/>
<title>OSXPhotos Command Line Interface (CLI) - osxphotos 0.55.2 documentation</title>
<title>OSXPhotos Command Line Interface (CLI) - osxphotos 0.55.3 documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=d81277517bee4d6b0349d71bb2661d4890b5617c" />
<link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
@@ -124,7 +124,7 @@
</label>
</div>
<div class="header-center">
<a href="index.html"><div class="brand">osxphotos 0.55.2 documentation</div></a>
<a href="index.html"><div class="brand">osxphotos 0.55.3 documentation</div></a>
</div>
<div class="header-right">
<div class="theme-toggle-container theme-toggle-header">
@@ -147,7 +147,7 @@
<div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
<span class="sidebar-brand-text">osxphotos 0.55.2 documentation</span>
<span class="sidebar-brand-text">osxphotos 0.55.3 documentation</span>
</a><form class="sidebar-search-container" method="get" action="search.html" role="search">
<input class="sidebar-search" placeholder=Search name="q" aria-label="Search">
@@ -530,12 +530,17 @@ with <cite>osxphotos export</cite> in the future will work correctly and not unn
<section id="osxphotos-export">
<h3>export<a class="headerlink" href="#osxphotos-export" title="Permalink to this heading">#</a></h3>
<p>Export photos from the Photos database.
Export path DEST is required.
Optionally, query the Photos database using 1 or more search options;
if more than one option is provided, they are treated as “AND”
Export path DEST is required.</p>
<p>Optionally, query the Photos database using 1 or more search options;
if more than one different option is provided, they are treated as “AND”
(e.g. search for photos matching all options).
If no query options are provided, all photos will be exported.
By default, all versions of all photos will be exported including edited
If the same query option is provided multiple times, they are treated as
“OR” (e.g. search for photos matching any of the options).
If no query options are provided, all photos will be exported.</p>
<p>For example, adding the query options:</p>
<p>–person “John Doe” –person “Jane Doe” –keyword “vacation”</p>
<p>will export all photos with either person of (“John Doe” OR “Jane Doe”) AND keyword of “vacation”</p>
<p>By default, all versions of all photos will be exported including edited
versions, live photo movies, burst photos, and associated raw images.
See –skip-edited, –skip-live, –skip-bursts, and –skip-raw options
to modify this behavior.</p>
@@ -1029,6 +1034,12 @@ to modify this behavior.</p>
<dd><p>Only export new or updated files. Unlike –update, –force-update will re-export photos if their metadata has changed even if this would not otherwise trigger an export. See also –update and notes below on export and –update.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-osxphotos-export-update-errors">
<span class="sig-name descname"><span class="pre">--update-errors</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-update-errors" title="Permalink to this definition">#</a></dt>
<dd><p>Update files that were previously exported but produced errors during export. For example, if a file produced an error with –exiftool due to bad metadata, this option will re-export the file and attempt to write the metadata again when used with –exiftool and –update. Without –update-errors, photos that were successfully exported but generated an error or warning during export will not be re-attempted if metadata has not changed. Must be used with –update.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-osxphotos-export-ignore-signature">
<span class="sig-name descname"><span class="pre">--ignore-signature</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-ignore-signature" title="Permalink to this definition">#</a></dt>
@@ -1511,6 +1522,18 @@ to modify this behavior.</p>
<dd><p>Print information about FILE_PATH contained in the database.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-osxphotos-exportdb-errors">
<span class="sig-name descname"><span class="pre">--errors</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-exportdb-errors" title="Permalink to this definition">#</a></dt>
<dd><p>Print list of files that had warnings/errors on export (from all runs).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-osxphotos-exportdb-last-errors">
<span class="sig-name descname"><span class="pre">--last-errors</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-exportdb-last-errors" title="Permalink to this definition">#</a></dt>
<dd><p>Print list of files that had warnings/errors on last export run.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-osxphotos-exportdb-uuid-files">
<span class="sig-name descname"><span class="pre">--uuid-files</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;UUID&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-exportdb-uuid-files" title="Permalink to this definition">#</a></dt>
@@ -2032,8 +2055,13 @@ Works best with a modern terminal like iTerm2 or Kitty.</p>
<section id="osxphotos-query">
<h3>query<a class="headerlink" href="#osxphotos-query" title="Permalink to this heading">#</a></h3>
<p>Query the Photos database using 1 or more search options;
if more than one option is provided, they are treated as “AND”
(e.g. search for photos matching all options).</p>
if more than one different option is provided, they are treated as “AND”
(e.g. search for photos matching all options).
If the same query option is provided multiple times, they are treated as
“OR” (e.g. search for photos matching any of the options).</p>
<p>For example:</p>
<p>osxphotos query –person “John Doe” –person “Jane Doe” –keyword “vacation”</p>
<p>will return all photos with either person of (“John Doe” OR “Jane Doe”) AND keyword of “vacation”</p>
<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>osxphotos query <span class="o">[</span>OPTIONS<span class="o">]</span> <span class="o">[</span>PHOTOS_LIBRARY<span class="o">]</span>...
</pre></div>
</div>