Update docs and registry

Author: ross-spencer

docs/jsonid/export.html

@@ -112,7 +112,7 @@ <h2 class="section-title" id="header-functions">Functions</h2>
             increment_id += 1
             fmt = pronom.Format(
                 id=increment_id,
-                name=f&#34;JSON (Baseline - fmt/817) ({encoding})&#34;,
+                name=f&#34;JSON (Baseline - {JSON_PUID}) ({encoding})&#34;,
                 version=&#34;&#34;,
                 puid=&#34;jsonid:0000&#34;,
                 mime=&#34;application/json&#34;,

docs/jsonid/file_processing.html

@@ -107,6 +107,7 @@ <h2 class="section-title" id="header-functions">Functions</h2>
         res = await analysis.analyse_input(base_obj.data, base_obj.content_for_analysis)
         res[&#34;doctype&#34;] = base_obj.doctype
         res[&#34;encoding&#34;] = base_obj.encoding
+        res[&#34;agent&#34;] = version.get_agent()
         if base_obj.doctype == registry.DOCTYPE_JSONL:
             res[&#34;compression&#34;] = base_obj.compression
             res.pop(&#34;content_length&#34;)

docs/jsonid/jsonid.html

@@ -45,6 +45,80 @@ <h1 class="title">Module <code>src.jsonid.jsonid</code></h1>
 <section>
 <h2 class="section-title" id="header-functions">Functions</h2>
 <dl>
+<dt id="src.jsonid.jsonid.analysis"><code class="name flex">
+<span>def <span class="ident">analysis</span></span>(<span>) ‑> None</span>
+</code></dt>
+<dd>
+<details class="source">
+<summary>
+<span>Expand source code</span>
+</summary>
+<pre><code class="python">def analysis() -&gt; None:
+    &#34;&#34;&#34;Secondary entry point for analysis functionality.
+
+    Enables us to call analysis from the command line once installed
+    via PyPi.
+    &#34;&#34;&#34;
+    parser = argparse.ArgumentParser(
+        prog=&#34;jsonida&#34;,
+        description=&#34;JSONID(A)nalysis&#34;,
+        epilog=&#34;for more information visit https://github.com/ffdev-info/jsonid&#34;,
+    )
+    parser.add_argument(
+        &#34;--debug&#34;,
+        help=&#34;use debug loggng&#34;,
+        required=False,
+        action=&#34;store_true&#34;,
+    )
+    parser.add_argument(
+        &#34;--path&#34;,
+        &#34;-p&#34;,
+        help=&#34;analyse a file in support of ruleset development and data preservation&#34;,
+        required=False,
+        type=str,
+        metavar=&#34;PATH&#34;,
+    )
+    args = parser.parse_args()
+
+    if not args.path:
+        parser.print_help(sys.stderr)
+        sys.exit()
+
+    # Initialize logging.
+    init_logging(args.debug)
+
+    # Attempt lookup in the registry. This should come first as it
+    # doesn&#39;t involve reading files.
+    _attempt_lookup(args)
+
+    # Determine which decode strategy to adopt.
+    strategy = _get_strategy(args)
+    if not strategy:
+        logger.error(
+            &#34;please ensure there is one remaining decode strategy, e.g. %s&#34;,
+            &#34;,&#34;.join(decode_strategies),
+        )
+        sys.exit(1)
+
+    # Enable graceful exit via signal handler...
+    def signal_handler(*args):  # pylint: disable=W0613
+        logger.info(&#34;exiting...&#34;)
+        sys.exit(0)
+
+    signal.signal(signal.SIGINT, signal_handler)
+
+    if args.path:
+        asyncio.run(
+            file_processing.analyse_data(
+                path=args.path,
+                strategy=strategy,
+            )
+        )</code></pre>
+</details>
+<div class="desc"><p>Secondary entry point for analysis functionality.</p>
+<p>Enables us to call analysis from the command line once installed
+via PyPi.</p></div>
+</dd>
 <dt id="src.jsonid.jsonid.init_logging"><code class="name flex">
 <span>def <span class="ident">init_logging</span></span>(<span>debug: bool)</span>
 </code></dt>
@@ -85,8 +159,8 @@ <h2 class="section-title" id="header-functions">Functions</h2>
 
     parser = argparse.ArgumentParser(
         prog=&#34;jsonid&#34;,
-        description=&#34;proof-of-concept identifier for JSON objects on disk based on identifying valid objects and their key-values&#34;,
-        epilog=&#34;for more information visit https://github.com/ffdev-info/json-id&#34;,
+        description=&#34;JSON(ID)entification of objects on disk based on identifying valid objects and their key-values&#34;,
+        epilog=&#34;for more information visit https://github.com/ffdev-info/jsonid&#34;,
     )
     parser.add_argument(
         &#34;--debug&#34;,
@@ -175,6 +249,7 @@ <h2 class="section-title" id="header-functions">Functions</h2>
     parser.add_argument(
         &#34;--analyse&#34;,
         &#34;--analyze&#34;,
+        &#34;--analysis&#34;,
         &#34;-a&#34;,
         help=&#34;analyse a file in support of ruleset development and data preservation&#34;,
         required=False,
@@ -282,6 +357,7 @@ <h2 class="section-title" id="header-functions">Functions</h2>
 </li>
 <li><h3><a href="#header-functions">Functions</a></h3>
 <ul class="">
+<li><code><a title="src.jsonid.jsonid.analysis" href="#src.jsonid.jsonid.analysis">analysis</a></code></li>
 <li><code><a title="src.jsonid.jsonid.init_logging" href="#src.jsonid.jsonid.init_logging">init_logging</a></code></li>
 <li><code><a title="src.jsonid.jsonid.main" href="#src.jsonid.jsonid.main">main</a></code></li>
 </ul>

docs/jsonid/pronom.html

@@ -314,9 +314,19 @@ <h2 class="section-title" id="header-functions">Functions</h2>
         for sig in fmt.external_signatures
         if sig.type.lower() == EXT
     ]
+
+    priority_ids = []
+    for id_ in fmt.priorities:
+        if id_ == str(fmt.id):
+            continue
+        if export.JSON_PUID in fmt.name:
+            # This is brittle. Understand how to make more robust.
+            continue
+        priority_ids.append(id_)
+
     priorities = [
         f&#34;&lt;HasPriorityOverFileFormatID&gt;{priority}&lt;/HasPriorityOverFileFormatID&gt;&#34;
-        for priority in fmt.priorities
+        for priority in priority_ids
     ]
     ff = f&#34;&#34;&#34;
 &lt;FileFormat ID=\&#34;{fmt.id}\&#34; Name=\&#34;{fmt.name}\&#34; PUID=\&#34;{fmt.puid}\&#34; Version=&#34;{fmt.version}&#34; MIMEType=\&#34;{fmt.mime}\&#34; FormatType=\&#34;{fmt.classification}\&#34; &gt;

docs/registry/index.htm

@@ -1468,6 +1468,44 @@ <h2 class="section-title" id="header-submodules">Contents</h2>
     <td class="markers"><pre>{'KEY': 'version', 'ISTYPE': 'int'}
 {'KEY': 'term', 'ISTYPE': 'dict'}
 </pre></td>
+</tr>
+<tr>
+    <td id="jrid:0081">jrid:0081</td>
+    <td class="markers">Tldraw v1</td>
+    <td>False</td>
+    <td>False</td>
+    <td>True</td>
+    <td>True</td>
+    <td class="markers"><pre>{'KEY': 'tldrawFileFormatVersion', 'ISTYPE': 'int'}
+{'KEY': 'records', 'ISTYPE': 'list'}
+{'GOTO': 'schema', 'KEY': 'schemaVersion', 'IS': 1}
+</pre></td>
+</tr>
+<tr>
+    <td id="jrid:0082">jrid:0082</td>
+    <td class="markers">Tldraw v2</td>
+    <td>False</td>
+    <td>False</td>
+    <td>True</td>
+    <td>True</td>
+    <td class="markers"><pre>{'KEY': 'tldrawFileFormatVersion', 'ISTYPE': 'int'}
+{'KEY': 'records', 'ISTYPE': 'list'}
+{'GOTO': 'schema', 'KEY': 'schemaVersion', 'IS': 2}
+</pre></td>
+</tr>
+<tr>
+    <td id="jrid:0083">jrid:0083</td>
+    <td class="markers">Irkasi visual thinking tool</td>
+    <td>False</td>
+    <td>False</td>
+    <td>False</td>
+    <td>True</td>
+    <td class="markers"><pre>{'KEY': 'schema', 'ISTYPE': 'dict'}
+{'KEY': 'shapes', 'ISTYPE': 'list'}
+{'KEY': 'rootShapeIds', 'ISTYPE': 'list'}
+{'KEY': 'bindings', 'ISTYPE': 'list'}
+{'KEY': 'assets', 'ISTYPE': 'list'}
+</pre></td>
 </tr>
 
             </tbody>
@@ -1571,6 +1609,9 @@ <h3>Contents</h3>
 <li class="contents"><code><a href="#jrid:0078">jrid:0078: Wikidata Query Service Sparql Results (Wikiprov/Siegfried) (Generic)</a></code></li>
 <li class="contents"><code><a href="#jrid:0079">jrid:0079: asciicast (asciinema.org) v2</a></code></li>
 <li class="contents"><code><a href="#jrid:0080">jrid:0080: asciicast (asciinema.org) v3</a></code></li>
+<li class="contents"><code><a href="#jrid:0081">jrid:0081: Tldraw v1</a></code></li>
+<li class="contents"><code><a href="#jrid:0082">jrid:0082: Tldraw v2</a></code></li>
+<li class="contents"><code><a href="#jrid:0083">jrid:0083: Irkasi visual thinking tool</a></code></li>
 
                </ul>
             </li>

docs/utils/jsonid2pronom.html

@@ -131,7 +131,7 @@ <h2 class="section-title" id="header-functions">Functions</h2>
 
     for encoding in encodings:
         increment_id += 1
-        json_puid = &#34;jsonid2pronom/1&#34;
+        json_puid = f&#34;jsonid2pronom/{increment_id}&#34;
         name_ = f&#34;JSONID2PRONOM Conversion ({encoding})&#34;
         try:
             mime = &#34;application/json&#34;