{
  "__type": "IngestedDoc",
  "__tag": 4010,
  "_content": {},
  "_ordered_sections": [],
  "item_file": null,
  "item_line": null,
  "item_type": null,
  "aliases": [],
  "example_section_data": {
    "__type": "Section",
    "__tag": 4015,
    "children": [],
    "title": [],
    "level": 0,
    "target": null
  },
  "see_also": [],
  "signature": null,
  "references": null,
  "qa": "configuration",
  "arbitrary": [
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri gen"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is driven by a TOML configuration file — one file per library.  The file has two top-level sections:"
            }
          ]
        },
        {
          "__type": "BulletList",
          "__tag": 4053,
          "ordered": false,
          "start": 1,
          "children": [
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "[global]"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " — controls how "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "papyri gen"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " collects and processes the   library.  All keys described below live here unless stated otherwise."
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "[meta]"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " — human-readable metadata attached to the published bundle   (URLs, PyPI slug, version tag)."
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "module"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " key inside "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[global]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is the only "
            },
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "required"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " key. Everything else has a sensible default or is simply omitted when not needed."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Papyri configuration reference"
        }
      ],
      "level": 0,
      "target": "configuration"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "[global]\nmodule = 'mylib'\n\n[meta]\ngithub_slug = 'myorg/mylib'\ntag = 'v{version}'\npypi = 'mylib'",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Running "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri gen mylib.toml"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " against this file discovers "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "mylib"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ", processes every public object it finds, executes the docstring examples, and writes the DocBundle to "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "~/.papyri/data/mylib_<version>/"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Minimal example"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[global]"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " reference"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — "
            },
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "required"
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The importable root package name.  "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri gen"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " imports this name and walks its public API."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "module = 'numpy'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "module"
        }
      ],
      "level": 2,
      "target": "config-module"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "list[str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[]"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Extra submodules to collect in addition to the root.  Use this when public objects live under subpackages that are not reachable just by importing the root.  Names are relative to "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "module"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "; "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'fft'"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " means "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "numpy.fft"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "submodules = ['core', 'fft', 'linalg', 'ma', 'random']",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "submodules"
        }
      ],
      "level": 2,
      "target": "config-submodules"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "bool"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Whether to attempt to execute the code examples found in docstrings. Set to "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "false"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " to skip execution entirely (faster builds, no side-effects).  "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "execute_exclude_patterns"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " and "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "exclude_jedi"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " refine "
            },
            {
              "__type": "Emphasis",
              "__tag": 4047,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "which"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " objects are executed when this is "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Can be overridden on the command line with "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "--exec"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " / "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "--no-exec"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "execute_doctests = false",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "execute_doctests"
        }
      ],
      "level": 2,
      "target": "config-execute-doctests"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'raise' | 'fallback' | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Controls what happens when a docstring example raises an exception during execution."
            }
          ]
        },
        {
          "__type": "DefList",
          "__tag": 4033,
          "children": [
            {
              "__type": "DefListItem",
              "__tag": 4037,
              "dt": {
                "__type": "Paragraph",
                "__tag": 4045,
                "children": [
                  {
                    "__type": "InlineCode",
                    "__tag": 4051,
                    "value": "'raise'"
                  }
                ]
              },
              "dd": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "Re-raise the exception; the whole gen run aborts unless the object is    listed in "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "expected_errors"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "."
                    }
                  ]
                }
              ]
            },
            {
              "__type": "DefListItem",
              "__tag": 4037,
              "dt": {
                "__type": "Paragraph",
                "__tag": 4045,
                "children": [
                  {
                    "__type": "InlineCode",
                    "__tag": 4051,
                    "value": "'fallback'"
                  }
                ]
              },
              "dd": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "Log the failure and continue; the example is stored unevaluated.    Recommended for large third-party libraries where some examples are    known to break outside their own test environment."
                    }
                  ]
                }
              ]
            },
            {
              "__type": "DefListItem",
              "__tag": 4037,
              "dt": {
                "__type": "Paragraph",
                "__tag": 4045,
                "children": [
                  {
                    "__type": "Text",
                    "__tag": 4046,
                    "value": "omitted / "
                  },
                  {
                    "__type": "InlineCode",
                    "__tag": 4051,
                    "value": "null"
                  }
                ]
              },
              "dd": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "Same as "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "'raise'"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "."
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "exec_failure = 'fallback'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "exec_failure"
        }
      ],
      "level": 2,
      "target": "config-exec-failure"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "list[str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[]"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Qualified name "
            },
            {
              "__type": "Emphasis",
              "__tag": 4047,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "prefixes"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " (dotted, with optional "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ":"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "-separated attribute path) whose docstring examples must "
            },
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "not"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " be executed. Matching uses "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str.startswith"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ", so "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'numpy._'"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " excludes every private submodule of numpy."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Use this instead of "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "exclude"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " when you only want to skip "
            },
            {
              "__type": "Emphasis",
              "__tag": 4047,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "execution"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " but still want the object documented in the bundle."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "execute_exclude_patterns = [\n    'numpy._',                               # all private submodules\n    'numpy.testing._priv',                   # a specific private subpackage\n    'numpy.errstate',                        # a single class\n    'numpy.core._multiarray_umath.bincount', # a single function\n]",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "execute_exclude_patterns"
        }
      ],
      "level": 2,
      "target": "config-execute-exclude-patterns"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "list[str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[]"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Fully-qualified names of objects to "
            },
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "omit entirely"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " from the bundle. The format is "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'package.module:ClassName'"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " or "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'package.module'"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ". Objects in this list are not collected, not executed, and not written to the IR."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "exclude = [\n    'numpy:tensordot',\n    'numpy.ma.core:MaskedArray.resize',\n]",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "exclude"
        }
      ],
      "level": 2,
      "target": "config-exclude"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "list[str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[]"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Qualified names for which Jedi type-inference should be "
            },
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "skipped"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ". Use when Jedi hangs, crashes, or produces wrong results for a specific object.  The object is still collected and executed (unless also in "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "exclude"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " or "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "execute_exclude_patterns"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "); only the Jedi inference step is bypassed."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "exclude_jedi = [\n    'scipy.linalg._sketches.clarkson_woodruff_transform',\n    'scipy.optimize._lsq.least_squares.least_squares',\n]",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "exclude_jedi"
        }
      ],
      "level": 2,
      "target": "config-exclude-jedi"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'log' | 'raise' | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Controls what happens when Jedi raises an error for an object that is "
            },
            {
              "__type": "Emphasis",
              "__tag": 4047,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "not"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " in "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "exclude_jedi"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "DefList",
          "__tag": 4033,
          "children": [
            {
              "__type": "DefListItem",
              "__tag": 4037,
              "dt": {
                "__type": "Paragraph",
                "__tag": 4045,
                "children": [
                  {
                    "__type": "InlineCode",
                    "__tag": 4051,
                    "value": "'log'"
                  }
                ]
              },
              "dd": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "Log the error and continue."
                    }
                  ]
                }
              ]
            },
            {
              "__type": "DefListItem",
              "__tag": 4037,
              "dt": {
                "__type": "Paragraph",
                "__tag": 4045,
                "children": [
                  {
                    "__type": "InlineCode",
                    "__tag": 4051,
                    "value": "'raise'"
                  }
                ]
              },
              "dd": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "Re-raise the error."
                    }
                  ]
                }
              ]
            },
            {
              "__type": "DefListItem",
              "__tag": 4037,
              "dt": {
                "__type": "Paragraph",
                "__tag": 4045,
                "children": [
                  {
                    "__type": "Text",
                    "__tag": 4046,
                    "value": "omitted / "
                  },
                  {
                    "__type": "InlineCode",
                    "__tag": 4051,
                    "value": "null"
                  }
                ]
              },
              "dd": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "Silently ignore."
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "jedi_failure_mode = 'log'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "jedi_failure_mode"
        }
      ],
      "level": 2,
      "target": "config-jedi-failure-mode"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "bool"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Whether to run Jedi type-inference on code examples at all.  When "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "false"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ", no Jedi calls are made and "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "exclude_jedi"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " has no effect."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Can be overridden on the command line with "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "--infer"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " / "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "--no-infer"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "infer = false",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "infer"
        }
      ],
      "level": 2,
      "target": "config-infer"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "bool"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "When "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ", the gen run aborts on the first unexpected error (i.e., any error not listed in "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "expected_errors"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ").  Set to "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "false"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " to collect all errors and print a summary at the end."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Can be overridden on the command line with "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "--fail-early"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "early_error = false",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "early_error"
        }
      ],
      "level": 2,
      "target": "config-early-error"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "dict[str, list[str]]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "{}"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "A mapping from exception class names to lists of fully-qualified object names that are "
            },
            {
              "__type": "Emphasis",
              "__tag": 4047,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "expected"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " to raise that exception during generation."
            }
          ]
        },
        {
          "__type": "BulletList",
          "__tag": 4053,
          "ordered": false,
          "start": 1,
          "children": [
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "If a listed object does "
                    },
                    {
                      "__type": "Strong",
                      "__tag": 4048,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "not"
                        }
                      ]
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " raise the expected exception, the gen   run fails."
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": "If an object raises an exception whose class is "
                    },
                    {
                      "__type": "Strong",
                      "__tag": 4048,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "not"
                        }
                      ]
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " listed here,   it is treated as an unexpected error (subject to "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "early_error"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " and   "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "exec_failure"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": ")."
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Use this to document known upstream issues without failing the build."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "[global.expected_errors]\nVisitCitationReferenceNotImplementedError = [\n    'numpy.fft',\n]\nWrongTypeAtField = [\n    'scipy.signal._ltisys:StateSpace',\n    'scipy.signal._ltisys:TransferFunction',\n]\nIncorrectInternalDocsLen = [\n    'matplotlib.dates:ConciseDateFormatter',\n]\nAssertionError = [\n    'scipy.optimize._linprog_ip:_ip_hsd',\n]\nNumpydocParseError = [\n    'distributed.client:default_client',\n]",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[global.expected_errors]"
        }
      ],
      "level": 2,
      "target": "config-expected-errors"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "dict[str, str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "{}"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Namespace aliases that are pre-imported before each example block is executed, so that short names used in examples resolve correctly."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Format     "
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "alias = 'package'        # equivalent to: import package as alias\nalias = 'package:name'   # equivalent to: from package import name as alias",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Without this, examples like "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "np.array([1, 2, 3])"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " fail because "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "np"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is not in scope."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "[global.implied_imports]\nnp          = 'numpy'\npd          = 'pandas'\nplt         = 'matplotlib.pyplot'\nxr          = 'xarray'\nget_ipython = 'IPython:get_ipython'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[global.implied_imports]"
        }
      ],
      "level": 2,
      "target": "config-implied-imports"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Filesystem path to the narrative documentation source tree (the directory containing "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".rst"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " files).  "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "~"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is expanded.  When set, "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri gen"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " walks this tree and includes the narrative pages in the bundle."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "docs_path = '~/dev/numpy/doc/source'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "docs_path"
        }
      ],
      "level": 2,
      "target": "config-docs-path"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "list[str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[]"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Path fragments to skip inside "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "docs_path"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ".  Any "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".rst"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " file whose path contains one of these strings is excluded from the bundle."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "narrative_exclude = [\n    'doc/source/reference/arrays.ndarray.rst',\n    'doc/source/_templates/',\n    'doc/source/user/how-to-how-to.rst',\n]",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "narrative_exclude"
        }
      ],
      "level": 2,
      "target": "config-narrative-exclude"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Filesystem path to a directory of Python example scripts to include in the bundle.  "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "~"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is expanded.  The scripts are executed and their outputs (including plots) are captured."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "examples_folder = '~/dev/matplotlib/examples/'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "examples_folder"
        }
      ],
      "level": 2,
      "target": "config-examples-folder"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "list[str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[]"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Relative paths (inside "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "examples_folder"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ") to skip.  The match is a suffix test against the example file's path string."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "examples_exclude = [\n    'logos2.py',\n    'multipage_pdf.py',\n    'units/artist_tests.py',\n]",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "examples_exclude"
        }
      ],
      "level": 2,
      "target": "config-examples-exclude"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Path to the package logo, relative to the config file.  The logo is embedded in the bundle and displayed by the viewer."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "logo = 'img/numpy_logo.png'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "logo"
        }
      ],
      "level": 2,
      "target": "config-logo"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "bool | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "When "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "true"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ", papyri waits for "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "matplotlib.pyplot.show()"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " calls inside example blocks to complete before moving on, ensuring that figure output is captured.  Set to "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "false"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " when matplotlib examples do not call "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "plt.show()"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " or when captures are handled another way."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "wait_for_plt_show = false",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "wait_for_plt_show"
        }
      ],
      "level": 2,
      "target": "config-wait-for-plt-show"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "URL of the project's source repository.  Informational; stored in the bundle metadata."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "source = 'https://github.com/numpy/numpy'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "source"
        }
      ],
      "level": 2,
      "target": "config-source"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "URL of the project's homepage.  Informational; stored in the bundle metadata.  If present in both "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[global]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " and "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[meta]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ", the "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[meta]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " value is authoritative for the viewer."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "homepage = 'https://numpy.org'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "homepage"
        }
      ],
      "level": 2,
      "target": "config-homepage-global"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str | null"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "null"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "URL of the project's official rendered documentation.  Informational; stored in the bundle metadata."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "docs = 'https://numpy.org/doc/stable/'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "docs"
        }
      ],
      "level": 2,
      "target": "config-docs"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "dict[str, str]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " — default "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "{}"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Custom RST directive handlers to register for this bundle.  Keys are directive names as they appear in RST (e.g. "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "mydirective"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " for "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".. mydirective::"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "); values are "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "'module:callable'"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " strings pointing to the handler function."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "[global.directives]\nmydirective = 'mylib.docs:_mydirective_handler'",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "To silently drop a directive instead of raising an error, map it to "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri.directives:drop"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ":"
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "[global.directives]\ntestsetup   = 'papyri.directives:drop'\ntestcleanup = 'papyri.directives:drop'\nplot        = 'papyri.directives:drop'",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The handler callable must accept "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "(argument, options, content)"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " and return an IR node or "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "None"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[global.directives]"
        }
      ],
      "level": 2,
      "target": "config-directives"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[meta]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " section holds metadata attached verbatim to the published bundle.  All keys are optional but recommended for bundles intended for public consumption."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[meta]"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " reference"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "owner/repo"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " slug of the project's GitHub repository.  Used by papyri to construct links to source files and issues."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "github_slug = 'numpy/numpy'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "github_slug"
        }
      ],
      "level": 2,
      "target": "config-github-slug"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Git tag template for this bundle's release.  "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "{version}"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is interpolated with the package version at gen time; "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "{{version}}"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " produces a literal "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "{version}"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " in the tag string (useful when the upstream tag format already contains braces)."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "tag = 'v{version}'          # → v1.26.4\ntag = '{{version}}'         # → {version}\ntag = 'networkx-{version}'  # → networkx-2.7.1",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "tag"
        }
      ],
      "level": 2,
      "target": "config-tag"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "PyPI distribution name.  Used to construct links to the package on PyPI."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "pypi = 'numpy'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "pypi"
        }
      ],
      "level": 2,
      "target": "config-pypi"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "URL of the project's homepage."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "homepage = 'https://numpy.org/'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "homepage"
        }
      ],
      "level": 2,
      "target": "config-homepage-meta"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Type:"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "str"
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "URL of the project's official documentation."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "docspage = 'https://numpy.org/doc/1.26/'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "docspage"
        }
      ],
      "level": 2,
      "target": "config-docspage"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "All options override or supplement the TOML config."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "papyri gen [OPTIONS] FILE",
          "execution_status": null
        },
        {
          "__type": "Table",
          "__tag": 4065,
          "children": [
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": true,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Option"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Default"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Description"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "FILE"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "—"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Path to the "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": ".toml"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " configuration file. "
                        },
                        {
                          "__type": "Strong",
                          "__tag": 4048,
                          "children": [
                            {
                              "__type": "Text",
                              "__tag": 4046,
                              "value": "Required."
                            }
                          ]
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--infer / --no-infer"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "true"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Override "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "infer"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " from the config."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--exec / --no-exec"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "config value"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Override "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "execute_doctests"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " from the config."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--debug"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Enable debug-level logging."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--no-progress"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Disable progress bars (useful in CI or with "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "ipdb"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ")."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--dry-run"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Parse and collect, but do not write any output to disk."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--api / --no-api"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "true"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Include / skip the API documentation pass."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--examples / --no-examples"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "true"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Include / skip the examples pass."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--narrative / --no-narrative"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "true"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Include / skip the narrative documentation pass."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--fail"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Fail on the first error encountered."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--fail-early"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Override "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "early_error"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " from the config."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--fail-unseen-error"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Fail if any exception type not listed in "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "expected_errors"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " is raised."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--only TEXT"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "all objects"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Restrict generation to this qualified name (repeatable)."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--upload"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "After generation, upload the bundle to "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "$PAPYRI_UPLOAD_URL"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--pack"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "After generation, write a "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": ".papyri"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " artifact in the current directory."
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Environment variables read by "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "--upload"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ":"
            }
          ]
        },
        {
          "__type": "Table",
          "__tag": 4065,
          "children": [
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": true,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Variable"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Description"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "PAPYRI_UPLOAD_URL"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Viewer ingest endpoint (default: "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "http://localhost:4321/api/bundle"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ").     Overridden by a named target if "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "default_target"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " is set in     "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "~/.papyri/config.toml"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "PAPYRI_UPLOAD_TOKEN"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Bearer token for the ingest endpoint.  Overridden by a named target's     token or keychain entry if "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "default_target"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " is set."
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "papyri gen"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " CLI reference"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri upload"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " reads an optional user-level config file at "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "~/.papyri/config.toml"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": ".  It lets you define "
            },
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "named upload targets"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " so you can type "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri upload --to staging"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " instead of repeating a long URL and token on every invocation."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The file is separate from the per-library TOML config used by "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri gen"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "# ~/.papyri/config.toml\n\n[upload]\n# Optional: use this target when --to is not given.\ndefault_target = \"localhost\"\n\n# ── targets ────────────────────────────────────────────────────────────\n\n[upload.targets.localhost]\nurl = \"http://localhost:4321/api/bundle\"\n# No token needed for a local dev instance.\n\n[upload.targets.staging]\nurl   = \"https://staging.example.com/api/bundle\"\ntoken = \"my-staging-token\"        # plain-text — OK for dev/staging\n\n[upload.targets.production]\nurl      = \"https://docs.example.com/api/bundle\"\nkeychain = true                   # read token from system keychain",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "~/.papyri/config.toml"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " — user upload config"
        }
      ],
      "level": 1,
      "target": "upload-config"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Table",
          "__tag": 4065,
          "children": [
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": true,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Key"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Required"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Description"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "url"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Strong",
                          "__tag": 4048,
                          "children": [
                            {
                              "__type": "Text",
                              "__tag": 4046,
                              "value": "yes"
                            }
                          ]
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Full URL of the viewer's "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "/api/bundle"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " ingest endpoint."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "token"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "no"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Bearer token as plain text.  Cannot be combined with "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "keychain"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "keychain"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "no"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "When "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "true"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ", the token is fetched from the system keychain at     upload time.  See "
                        },
                        {
                          "__type": "CrossRef",
                          "__tag": 4002,
                          "value": "upload-keychain",
                          "reference": {
                            "__type": "LocalRef",
                            "__tag": 4022,
                            "kind": "docs",
                            "path": "configuration"
                          },
                          "kind": "exists"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ".  Cannot be combined with "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "token"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "."
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[upload.targets.<name>]"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " keys"
        }
      ],
      "level": 2,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Table",
          "__tag": 4065,
          "children": [
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": true,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Key"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Description"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "default_target"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Name of the target to use when "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--to"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " is not supplied.  Must     match a key under "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "[upload.targets]"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ".  Omit to keep the current     behaviour (fall through to "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "$PAPYRI_UPLOAD_URL"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / hardcoded     default)."
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "[upload]"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " keys"
        }
      ],
      "level": 2,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Setting "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "keychain = true"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " in a target tells "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri upload"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " to look up the bearer token from the OS credential store at upload time, rather than storing it in the config file.  The lookup uses the "
            },
            {
              "__type": "Link",
              "__tag": 4049,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "keyring"
                }
              ],
              "url": "https://pypi.org/project/keyring/",
              "title": ""
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " package (macOS Keychain, Windows Credential Manager, Linux Secret Service / KWallet)."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Install keyring support:"
                }
              ]
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "pip install \"papyri[keychain]\"",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Store a token (run once per machine / token rotation):"
                }
              ]
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "python -m keyring set papyri <target-name>\n# e.g.\npython -m keyring set papyri production",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "You will be prompted for the token value.  It is then encrypted and stored in the OS credential store; "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri upload"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " retrieves it automatically.  The token never appears in "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "~/.papyri/config.toml"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "."
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "If "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "keyring"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is not installed or no entry is found, the upload fails with a clear message explaining the fix."
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Storing tokens in the system keychain"
        }
      ],
      "level": 2,
      "target": "upload-keychain"
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "papyri upload [OPTIONS] PATH [PATH ...]",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Each "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "PATH"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " may be a "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".papyri"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " artifact (from "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "papyri pack"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "), a "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".zip"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " containing exactly one "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".papyri"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " artifact, or a DocBundle directory (packed on the fly)."
            }
          ]
        },
        {
          "__type": "Table",
          "__tag": 4065,
          "children": [
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": true,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Option"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Default"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Description"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--to NAME"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "—"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Named target from "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "~/.papyri/config.toml"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ".  Supplies the URL and     token for that target.  Explicit "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--url"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--token"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " flags     override "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--to"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--url"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "-u"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "see below"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Viewer ingest endpoint.  Overrides "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--to"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " and     "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "$PAPYRI_UPLOAD_URL"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--token"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "-t"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "see below"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Bearer token.  Overrides "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--to"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " and "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "$PAPYRI_UPLOAD_TOKEN"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": ".     Omit for local dev instances with no auth."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--verbose"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "-v"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Show per-step packing progress when building a bundle on the fly."
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "URL resolution order"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " (first match wins):"
            }
          ]
        },
        {
          "__type": "BulletList",
          "__tag": 4053,
          "ordered": true,
          "start": 1,
          "children": [
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "--url"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " flag"
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "--to"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " target's "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "url"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " (or "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "default_target"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " from config if "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "--to"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " is omitted)"
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "$PAPYRI_UPLOAD_URL"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " environment variable"
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "http://localhost:4321/api/bundle"
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Token resolution order"
                }
              ]
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " (first match wins):"
            }
          ]
        },
        {
          "__type": "BulletList",
          "__tag": 4053,
          "ordered": true,
          "start": 1,
          "children": [
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "--token"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " flag"
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "--to"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " target's "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "token"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " / "
                    },
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "keychain"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " entry"
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "InlineCode",
                      "__tag": 4051,
                      "value": "$PAPYRI_UPLOAD_TOKEN"
                    },
                    {
                      "__type": "Text",
                      "__tag": 4046,
                      "value": " environment variable"
                    }
                  ]
                }
              ]
            },
            {
              "__type": "ListItem",
              "__tag": 4054,
              "children": [
                {
                  "__type": "Paragraph",
                  "__tag": 4045,
                  "children": [
                    {
                      "__type": "Emphasis",
                      "__tag": 4047,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "(no token — omit the ``Authorization`` header)"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Strong",
              "__tag": 4048,
              "children": [
                {
                  "__type": "Text",
                  "__tag": 4046,
                  "value": "Typical workflows:"
                }
              ]
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "# Local dev (no config needed — hits localhost by default).\npapyri upload ~/.papyri/data/mylib_1.0/\n\n# Named target from config (URL + token resolved automatically).\npapyri upload --to staging mylib-1.0.papyri\n\n# Named target but override URL for a one-off.\npapyri upload --to production --url https://override.example.com/api/bundle mylib.papyri\n\n# One-off with explicit credentials (no config file needed).\npapyri upload --url https://docs.example.com/api/bundle --token $MY_TOKEN mylib.papyri",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "papyri upload"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " CLI reference"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "papyri pack [OPTIONS] [BUNDLE_DIR]",
          "execution_status": null
        },
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "Validates a DocBundle directory and writes a deterministic "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": ".papyri"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " artifact (gzipped canonical-CBOR "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "Bundle"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " node).  Running pack twice on the same input produces byte-identical output.  If "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "BUNDLE_DIR"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is omitted, every directory under "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "~/.papyri/data/"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " is packed in turn."
            }
          ]
        },
        {
          "__type": "Table",
          "__tag": 4065,
          "children": [
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": true,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Option"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Default"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Description"
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "BUNDLE_DIR"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "all bundles under "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "~/.papyri/data/"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "DocBundle directory to pack."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--output"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "-o"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "<module>-<version>.papyri"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " in cwd"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Output file or directory (single-bundle mode only)."
                        }
                      ]
                    }
                  ]
                }
              ]
            },
            {
              "__type": "TableRow",
              "__tag": 4068,
              "header": false,
              "children": [
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "--verbose"
                        },
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": " / "
                        },
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "-v"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "InlineCode",
                          "__tag": 4051,
                          "value": "false"
                        }
                      ]
                    }
                  ]
                },
                {
                  "__type": "TableCell",
                  "__tag": 4069,
                  "children": [
                    {
                      "__type": "Paragraph",
                      "__tag": 4045,
                      "children": [
                        {
                          "__type": "Text",
                          "__tag": 4046,
                          "value": "Show per-step progress."
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "title": [
        {
          "__type": "InlineCode",
          "__tag": 4051,
          "value": "papyri pack"
        },
        {
          "__type": "Text",
          "__tag": 4046,
          "value": " CLI reference"
        }
      ],
      "level": 1,
      "target": null
    },
    {
      "__type": "Section",
      "__tag": 4015,
      "children": [
        {
          "__type": "Paragraph",
          "__tag": 4045,
          "children": [
            {
              "__type": "Text",
              "__tag": 4046,
              "value": "The following file shows every "
            },
            {
              "__type": "InlineCode",
              "__tag": 4051,
              "value": "[global]"
            },
            {
              "__type": "Text",
              "__tag": 4046,
              "value": " key in one place."
            }
          ]
        },
        {
          "__type": "Code",
          "__tag": 4050,
          "value": "[global]\n# ── required ───────────────────────────────────────────────────────────\nmodule = 'mylib'\n\n# ── discovery ──────────────────────────────────────────────────────────\nsubmodules = ['io', 'utils']\n\n# Completely skip these objects (no collection, no execution, no IR entry).\nexclude = [\n    'mylib.internal:_PrivateHelper',\n    'mylib.compat',\n]\n\n# ── doctest execution ───────────────────────────────────────────────────\nexecute_doctests = true\n\n# What to do when a doctest raises unexpectedly: 'raise' or 'fallback'.\nexec_failure = 'fallback'\n\n# Skip execution for these prefixes (object still documented).\nexecute_exclude_patterns = [\n    'mylib._',                    # all private submodules\n    'mylib.heavy:slow_function',  # a specific function\n]\n\n# Skip Jedi inference for objects where it hangs or crashes.\nexclude_jedi = [\n    'mylib.ffi:RawPointer',\n]\n\n# What to do when Jedi errors: 'log' or 'raise'.\njedi_failure_mode = 'log'\n\n# Run Jedi at all?\ninfer = true\n\n# Wait for plt.show() before capturing figure output.\nwait_for_plt_show = true\n\n# ── error handling ──────────────────────────────────────────────────────\n# Abort on first unexpected error (override with --fail-early).\nearly_error = false\n\n# ── narrative docs ──────────────────────────────────────────────────────\ndocs_path = '~/dev/mylib/docs/source'\n\nnarrative_exclude = [\n    '_build/',\n    '_templates/',\n    'api/generated/',\n]\n\n# ── examples ────────────────────────────────────────────────────────────\nexamples_folder = '~/dev/mylib/examples/'\n\nexamples_exclude = [\n    'slow_demo.py',\n    'requires_gpu/demo.py',\n]\n\n# ── appearance ───────────────────────────────────────────────────────────\nlogo = 'img/mylib_logo.png'\n\n# ── informational URLs ───────────────────────────────────────────────────\nsource   = 'https://github.com/myorg/mylib'\nhomepage = 'https://mylib.readthedocs.io/'\ndocs     = 'https://mylib.readthedocs.io/en/stable/'\n\n# ── pre-imported aliases for example execution ───────────────────────────\n[global.implied_imports]\nml = 'mylib'\nnp = 'numpy'\npd = 'pandas'\n\n# ── known failures (build succeeds despite these errors) ─────────────────\n[global.expected_errors]\nWrongTypeAtField = [\n    'mylib.io:read_csv',\n]\nIncorrectInternalDocsLen = [\n    'mylib.utils:_internal_helper',\n]\n\n# ── custom RST directives ─────────────────────────────────────────────────\n[global.directives]\nmyspecial   = 'mylib.docs:_myspecial_handler'\ntestsetup   = 'papyri.directives:drop'\ntestcleanup = 'papyri.directives:drop'\n\n# ── bundle metadata ───────────────────────────────────────────────────────\n[meta]\ngithub_slug = 'myorg/mylib'\ntag         = 'v{version}'\npypi        = 'mylib'\nhomepage    = 'https://mylib.readthedocs.io/'\ndocspage    = 'https://mylib.readthedocs.io/en/stable/'",
          "execution_status": null
        }
      ],
      "title": [
        {
          "__type": "Text",
          "__tag": 4046,
          "value": "Full annotated example"
        }
      ],
      "level": 1,
      "target": null
    }
  ],
  "local_refs": []
}