Updated docs

README.md

@@ -387,9 +387,9 @@ As mentioned above, Photos renames JPEG images that have been edited with the ".
 
 #### Specifying the Photos library
 
-All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the "Option" key while opening Photos, you can select an alternate Photos library.  If you don't specify which library to use, osxphotos will try find the last opened library.  Occasionally it can't determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the `--db` option. (db is short for database and is so named because osxphotos operates on the database that Photos uses to manage your Photos library).
+All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the "Option" key while opening Photos, you can select an alternate Photos library.  If you don't specify which library to use, osxphotos will try find the last opened library.  Occasionally it can't determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the `--library` option.
 
-`osxphotos export /path/to/export --db ~/Pictures/MyAlternateLibrary.photoslibrary`
+`osxphotos export /path/to/export --library ~/Pictures/MyAlternateLibrary.photoslibrary`
 
 #### Missing photos
 
@@ -664,7 +664,7 @@ Here's a comprehensive use case from an actual osxphotos user that integrates ma
     Finally, use `--strip` to remove any leading or trailing whitespace from processed
     template fields.
 
-`osxphotos export ~/Desktop/folder for exported videos/ --keyword Quik --only-movies --db /path to my.photoslibrary --touch-file --finder-tag-keywords --person-keyword --xattr-template findercomment "{title}{title?{descr?{newline},},}{descr}" --exiftool-merge-keywords --exiftool-merge-persons --exiftool --strip`
+`osxphotos export ~/Desktop/folder for exported videos/ --keyword Quik --only-movies --library /path to my.photoslibrary --touch-file --finder-tag-keywords --person-keyword --xattr-template findercomment "{title}{title?{descr?{newline},},}{descr}" --exiftool-merge-keywords --exiftool-merge-persons --exiftool --strip`
 
 #### Color Themes
 
@@ -680,7 +680,7 @@ osxphotos is very flexible.  If you merely want to backup your Photos library, t
 `osxphotos help export`
 <!-- OSXPHOTOS-EXPORT-USAGE:START - Do not remove or modify this section -->
 ```
-Usage: osxphotos export [OPTIONS] [PHOTOS_LIBRARY]... DEST
+Usage: osxphotos export [OPTIONS] DEST
 
   Export photos from the Photos database. Export path DEST is required.
 
@@ -1495,10 +1495,17 @@ Options:
                                   directory.  If --exportdb is specified, it
                                   will be saved to the specified file.
   --ramdb                         Copy export database to memory during export;
-                                  may improve performance when exporting over a
+                                  will improve performance when exporting over a
                                   network or slow disk but could result in
                                   losing update state information if the program
-                                  is interrupted or crashes.
+                                  is interrupted or crashes. See also
+                                  --checkpoint.
+  --checkpoint NUMBER_OF_PHOTOS   When used with --ramdb, periodically save the
+                                  export database back to disk after processing
+                                  NUMBER_OF_PHOTOS to avoid data loss if export
+                                  is cancelled or crashes. Default is 1000; to
+                                  prevent checkpointing of database, use
+                                  `--checkpoint 0`  [x>=0]
   --tmpdir DIR                    Specify alternate temporary directory. Default
                                   is system temporary directory. osxphotos needs
                                   to create a number of temporary files during

docs/_modules/osxphotos/_constants.html

@@ -4,8 +4,8 @@
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
-    <!-- Generated with Sphinx 7.2.5 and Furo 2023.08.19 -->
-        <title>osxphotos._constants - osxphotos 0.63.5 documentation</title>
+    <!-- Generated with Sphinx 7.2.6 and Furo 2023.09.10 -->
+        <title>osxphotos._constants - osxphotos 0.64.3 documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="../../_static/styles/furo.css?v=135e06be" />
     <link rel="stylesheet" type="text/css" href="../../_static/copybutton.css?v=76b2166b" />
@@ -123,7 +123,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../../index.html"><div class="brand">osxphotos 0.63.5 documentation</div></a>
+      <a href="../../index.html"><div class="brand">osxphotos 0.64.3 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -146,7 +146,7 @@
       <div class="sidebar-sticky"><a class="sidebar-brand" href="../../index.html">
 
 
-  <span class="sidebar-brand-text">osxphotos 0.63.5 documentation</span>
+  <span class="sidebar-brand-text">osxphotos 0.64.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">
@@ -711,6 +711,9 @@ <h1>Source code for osxphotos._constants</h1><div class="highlight"><pre>
 <span class="c1"># pass SQLITE_CHECK_SAME_THREAD to sqlite3.connect() to enable multithreaded access on systems that support it</span>
 <span class="n">SQLITE_CHECK_SAME_THREAD</span> <span class="o">=</span> <span class="ow">not</span> <span class="n">sqlite3</span><span class="o">.</span><span class="n">threadsafety</span> <span class="o">==</span> <span class="mi">3</span>
 <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">SQLITE_CHECK_SAME_THREAD</span><span class="si">=}</span><span class="s2">, </span><span class="si">{</span><span class="n">sqlite3</span><span class="o">.</span><span class="n">threadsafety</span><span class="si">=}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="c1"># default value for --checkpoint</span>
+<span class="n">DEFAULT_CHECKPOINT</span> <span class="o">=</span> <span class="mi">1000</span>
 </pre></div>
         </article>
       </div>
@@ -743,7 +746,7 @@ <h1>Source code for osxphotos._constants</h1><div class="highlight"><pre>
 
     </aside>
   </div>
-</div><script src="../../_static/documentation_options.js?v=3442d150"></script>
+</div><script src="../../_static/documentation_options.js?v=d5e8344a"></script>
     <script src="../../_static/doctools.js?v=888ff710"></script>
     <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/scripts/furo.js?v=32e29ea5"></script>

docs/_sources/tutorial.rst.txt

@@ -176,9 +176,9 @@ As mentioned above, Photos renames JPEG images that have been edited with the ".
 Specifying the Photos library
 -----------------------------
 
-All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the "Option" key while opening Photos, you can select an alternate Photos library.  If you don't specify which library to use, osxphotos will try find the last opened library.  Occasionally it can't determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the ``--db`` option. (db is short for database and is so named because osxphotos operates on the database that Photos uses to manage your Photos library).
+All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the "Option" key while opening Photos, you can select an alternate Photos library.  If you don't specify which library to use, osxphotos will try find the last opened library.  Occasionally it can't determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the ``--library`` option.
 
-``osxphotos export /path/to/export --db ~/Pictures/MyAlternateLibrary.photoslibrary``
+``osxphotos export /path/to/export --library ~/Pictures/MyAlternateLibrary.photoslibrary``
 
 Missing photos
 --------------
@@ -479,7 +479,7 @@ Here's a comprehensive use case from an actual osxphotos user that integrates ma
    template fields.
 
 
-``osxphotos export ~/Desktop/folder for exported videos/ --keyword Quik --only-movies --db /path to my.photoslibrary --touch-file --finder-tag-keywords --person-keyword --xattr-template findercomment "{title}{title?{descr?{newline},},}{descr}" --exiftool-merge-keywords --exiftool-merge-persons --exiftool --strip``
+``osxphotos export ~/Desktop/folder for exported videos/ --keyword Quik --only-movies --library /path to my.photoslibrary --touch-file --finder-tag-keywords --person-keyword --xattr-template findercomment "{title}{title?{descr?{newline},},}{descr}" --exiftool-merge-keywords --exiftool-merge-persons --exiftool --strip``
 
 Color Themes
 ------------

docs/tutorial.html

@@ -303,8 +303,8 @@ <h2>Edited photos<a class="headerlink" href="#edited-photos" title="Link to this
 </section>
 <section id="specifying-the-photos-library">
 <h2>Specifying the Photos library<a class="headerlink" href="#specifying-the-photos-library" title="Link to this heading">#</a></h2>
-<p>All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the “Option” key while opening Photos, you can select an alternate Photos library.  If you don’t specify which library to use, osxphotos will try find the last opened library.  Occasionally it can’t determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the <code class="docutils literal notranslate"><span class="pre">--db</span></code> option. (db is short for database and is so named because osxphotos operates on the database that Photos uses to manage your Photos library).</p>
-<p><code class="docutils literal notranslate"><span class="pre">osxphotos</span> <span class="pre">export</span> <span class="pre">/path/to/export</span> <span class="pre">--db</span> <span class="pre">~/Pictures/MyAlternateLibrary.photoslibrary</span></code></p>
+<p>All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the “Option” key while opening Photos, you can select an alternate Photos library.  If you don’t specify which library to use, osxphotos will try find the last opened library.  Occasionally it can’t determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the <code class="docutils literal notranslate"><span class="pre">--library</span></code> option.</p>
+<p><code class="docutils literal notranslate"><span class="pre">osxphotos</span> <span class="pre">export</span> <span class="pre">/path/to/export</span> <span class="pre">--library</span> <span class="pre">~/Pictures/MyAlternateLibrary.photoslibrary</span></code></p>
 </section>
 <section id="missing-photos">
 <h2>Missing photos<a class="headerlink" href="#missing-photos" title="Link to this heading">#</a></h2>
@@ -509,7 +509,7 @@ <h2>An example from an actual osxphotos user<a class="headerlink" href="#an-exam
 template fields.
 </pre></div>
 </div>
-<p><code class="docutils literal notranslate"><span class="pre">osxphotos</span> <span class="pre">export</span> <span class="pre">~/Desktop/folder</span> <span class="pre">for</span> <span class="pre">exported</span> <span class="pre">videos/</span> <span class="pre">--keyword</span> <span class="pre">Quik</span> <span class="pre">--only-movies</span> <span class="pre">--db</span> <span class="pre">/path</span> <span class="pre">to</span> <span class="pre">my.photoslibrary</span> <span class="pre">--touch-file</span> <span class="pre">--finder-tag-keywords</span> <span class="pre">--person-keyword</span> <span class="pre">--xattr-template</span> <span class="pre">findercomment</span> <span class="pre">&quot;{title}{title?{descr?{newline},},}{descr}&quot;</span> <span class="pre">--exiftool-merge-keywords</span> <span class="pre">--exiftool-merge-persons</span> <span class="pre">--exiftool</span> <span class="pre">--strip</span></code></p>
+<p><code class="docutils literal notranslate"><span class="pre">osxphotos</span> <span class="pre">export</span> <span class="pre">~/Desktop/folder</span> <span class="pre">for</span> <span class="pre">exported</span> <span class="pre">videos/</span> <span class="pre">--keyword</span> <span class="pre">Quik</span> <span class="pre">--only-movies</span> <span class="pre">--library</span> <span class="pre">/path</span> <span class="pre">to</span> <span class="pre">my.photoslibrary</span> <span class="pre">--touch-file</span> <span class="pre">--finder-tag-keywords</span> <span class="pre">--person-keyword</span> <span class="pre">--xattr-template</span> <span class="pre">findercomment</span> <span class="pre">&quot;{title}{title?{descr?{newline},},}{descr}&quot;</span> <span class="pre">--exiftool-merge-keywords</span> <span class="pre">--exiftool-merge-persons</span> <span class="pre">--exiftool</span> <span class="pre">--strip</span></code></p>
 </section>
 <section id="color-themes">
 <h2>Color Themes<a class="headerlink" href="#color-themes" title="Link to this heading">#</a></h2>

docsrc/source/tutorial.rst

@@ -176,9 +176,9 @@ As mentioned above, Photos renames JPEG images that have been edited with the ".
 Specifying the Photos library
 -----------------------------
 
-All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the "Option" key while opening Photos, you can select an alternate Photos library.  If you don't specify which library to use, osxphotos will try find the last opened library.  Occasionally it can't determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the ``--db`` option. (db is short for database and is so named because osxphotos operates on the database that Photos uses to manage your Photos library).
+All the above commands operate on the default Photos library.  Most users only use a single Photos library which is also known as the System Photo Library.  It is possible to use Photos with more than one library.  For example, if you hold down the "Option" key while opening Photos, you can select an alternate Photos library.  If you don't specify which library to use, osxphotos will try find the last opened library.  Occasionally it can't determine this and in that case, it will use the System Photos Library.  If you use more than one Photos library and want to explicitly specify which library to use, you can do so with the ``--library`` option.
 
-``osxphotos export /path/to/export --db ~/Pictures/MyAlternateLibrary.photoslibrary``
+``osxphotos export /path/to/export --library ~/Pictures/MyAlternateLibrary.photoslibrary``
 
 Missing photos
 --------------
@@ -479,7 +479,7 @@ Here's a comprehensive use case from an actual osxphotos user that integrates ma
    template fields.
 
 
-``osxphotos export ~/Desktop/folder for exported videos/ --keyword Quik --only-movies --db /path to my.photoslibrary --touch-file --finder-tag-keywords --person-keyword --xattr-template findercomment "{title}{title?{descr?{newline},},}{descr}" --exiftool-merge-keywords --exiftool-merge-persons --exiftool --strip``
+``osxphotos export ~/Desktop/folder for exported videos/ --keyword Quik --only-movies --library /path to my.photoslibrary --touch-file --finder-tag-keywords --person-keyword --xattr-template findercomment "{title}{title?{descr?{newline},},}{descr}" --exiftool-merge-keywords --exiftool-merge-persons --exiftool --strip``
 
 Color Themes
 ------------